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INTRODUCTION 


The 81000 CANDE program provides generalized file preparation and 
updating capabilities in an interactives terminal oriented envi= 
ronment. | | ) 


The 81000 CANDE prograa runs in conjunction with the B1000 NOL 
syste@e The NOL@generated network controller performs ait the 
data communication related functions» white CANDE perforss file 
updating and text editing functions. CANDE can support a saxinua 
of 64 concurrent userse fhe number of stations defined in the 


network controller may be any number Liaited only by NOL 
constraints. CANDE*%s remote file C"CANDEQUEUE") is oapened by 
default with ‘number of stations® C*'NST*)=70 but this value aay 


be modified or filesequated in the usual manner. 


A basic usercodespassword type of security is available with the 
systeme The user logs on with a usercode and password and» if 
privileged» may access any file. If the user ts nonprivileged he 
may access any file with his own usercode as the aultifilerid. 


RELATED DOCUMENTATION 


NUMBER TITLE 
PeSe 2212 5223 Network Definition Language 
P.Se 2212 5215 NOL/LIBRARY 
PeSe 2219 0482 Supervisory MCS 
P.Se 2212 5412 © OC/AUDIT 
PeSe 2219 0185 _ CANDE/ANALYZER> 
P.eSe 2219 0136 HOST/RJE 
PeSe 2219 0102 SYSTE M/MAKEUSER 
1073715 81000 NOL Reference Manual 
1068731 


B1000 Software Operations Guide 


* 
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SYNTAX SPECIFICATIONS 
SYNTAX QLAGRAMS 


The principle means of displaying CANDE command syntax is the 
syntax diagrame This method has been chosen because it affords a 
very concise and lucid exposition of syntax involving defaults» 
alternatives» and iterationss it 31S rigorous without being 
cumbersome. There are few formal rules to renenber: The basic 
rule is that any path traced along the forward directions of the 
arrows wilt produce a syntacticaliy valid coamand. Vertical 
tracks are traced downward on the Left and upward on the right. 
The foitowing examptes itlustrate the technique: 


i<- » oo 


| 4 | 
aaa a ROW <n «2 eb 22 we THE e3c3@@“w327"2 BoAT 20 2D SD OD ODED ED GD OD OD OD OD ae Oe on ee ee a ey > 
ae | | 
I-- YOUR -->1 [== GENTLY ==>! 
>>ee DOWN a Scans aan anaees = S222 e =e e STREAM ==> Z 
| a a - | 
j-- THE a aaa aaron ha | 


! | 1 1 i 
j-o OLD ==> | fm- MILL “=>I 


Valid productions of this diagram are: 


ROW THE SOAT DOWN“STREAM | | 

ROW» ROW» ROWe YOUR SOAT GENTLY DOWN THE STREAM © | 
ROW» ROW» ROW» ROW THE BOAT GENTLY OGWN THE OLD STREAM 
ROW YOUR SOAT DOWN THE MILL STREAM | | | 
ROW THE BOAT DOWN THE OLD MILL STREAM 


eee an wih ttatier nc E-ASDIM DARN ey ab thin dee eT AN blab be LANG oe cb iNET Raitnen WIA 30, 
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The following convention is used to control the number of itera- 


tions: 


>2e2e ACRQSS THE sca isc tas sic es teks Ves eu cn i tc cls nb ab ew esto an MISSOURI asaeaenven>?f 


i | 
| qeweee , eaee2eean. J iN onan | 
i 7 } 
jeer § I G ees en ewewoeeoa=)» | 


j s#ecc2ee WIDE oe ee ween eoeeeee)> |j 


j i 
] - =p «s «0 a8 MUDD y 2 anne wana > { 


The “bridge” over the "1" can be crossed only one time» so a 
maximnua of one comma may appear. Valid productions are: 


ACROSS 
ACROSS 


ACROSS) 


ACROSS 
— ACROSS 


THE 
THE 
THE 
THE 
THE 


MISSOURI 

WIDE MISSOURI 2 
BIG» MUDDY MISSOURI 
MUDDY» WIDE MISSOURI 
BIGs BIG MISSOURI 
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An "*" associated with the bridge number indicates that the path 
must be crossed at least one time. If the previous exampte is 
changed to the fotloawing: 


{ ¢<eseeeeeeee > ese eaenanooeoe | 
i | 
Powe ACROSS THE wnee/ia\ eee BIG Sea eu eaoaoaaaaanea MISSOURI aamae>¥# 
J | 
{ *s2e2ee2e WIDE. see aan waewaaae > { 
i iy 
] weoronn, HEEP aaa 
I i 


| oe2eere MUDDY ese eneneeuwoe=)5 | 


Then proper syntax is obtained ad crossing the bridge exactty one time. 
Valid productions ares 


ACROSS THE BIG MISSOURI 

ACROSS THE BIG» WIDE MISSOURI 

ACROSS THE BIGs WIDE» DEEP MISSOURI 
ACROSS THE BIGs WIDE» DEEP» MUDCY MISSOURI 


BPR EB eate}eebecpei sth pce se fthant cet ise tee eet o™ BEE EY oy og Wate, Qe see Sad, Coenen edkey hal 5 dbs : 
E ae tie de site Iveta ae ey Wee Sle Acad iy ey ee Rlntmeasen he eettiomicn nk saath oan * Fe 


- 
Sesh 
eat 
hs 
pa 
ad 
Bets 
sch 
as 


mes RE 


pn EPRURRR DURE EPPREDED 


CT i a ee ee eer rn eee tt we ee ee eee ee ee ee ee ee ee ee ee 
-- 
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SYNTAX CONVENTIONS 


CANDE commands are constructed of letters» digits» special char- 
acters» and blanks. Letters and digits are alphanumeric charac 
terss all other nonwblanks are delimiters. Alphanumeric charac~ 
ters may be separated into such itesms as integers» keywords and 
identifiers. Atl integers» keywords and identifiers may be 
entered in either uppercase or lowerecase characters» or any 
mixture of these. 


Keywords 


Upperwcase letters in syntax diagrams indicate keywords which 
appear literally in the command. In many cases it is permissible 
to abbreviate the keyword by its initial or first few letters. 
In the syntax presentation hereines underlining marks the letters 
which must appears’ the rest are opttionat. 


Blanks 


Blanks in CANDE commands serve to separate syntactic items and 
May appear freely except within certain text fields» where they 


become significant characters. Blanks are optional on either 
side of a delimiter. Whenever one alphanumeric item (Ckeyword>» 


identifier,» integer » etc.) follows another with no separating 
delimiter» they must be separated by at least ane blank. | 


End of statement 


The end of a statement is indicated by the following notation: 


geen ea 
oF aeintntinte Witktnts Ae ten 


i i ee ee ee ee ee ee ee e D so cree} * ee ° ell lh ee ee ee a ae ee ee” Se . 
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SYNTACTIC VARIABLES 


Lower~case letters» words» and phrases within angle brackets (<>) 
in the syntax diagrams are syntactic variables» which represent 
information to be supptied by the usere A particular variable 
fay represent a single charactar» a simpte construct such as an 
integer or text strings or arelativety complicated construct. 
Most variables are defined where used. Several variabies and 
types of variables which are frequently encountered are defined 
here. 


Identifier 


An identifier is a string of characters used to represent some 
entity» such as a file» or a usercode. Identifiers in CANDE say 
vary tn tength from one to ten characters» and are coapcsed of 
characters and digits only» with the first character being a 
non“tntegere : 


Integer 


An integer ts specified by a string of digits which represent the 
decimal value of the integer. Syntactic variables of this type 
Occur frequently in CANDE. Some common examples are <s> 
Csequence number)» <col> (column number)» and <base> and <itnc> 
Csequence base and tncrement). | 


Delimiters 


The delimiters may be any character» other than alphanumerics» 
periods (€".") or underscores (€"_")» which do not occur in the 
delimited field or have some other special meaning in the current 
contexte These instances are detailed with each use of <delim>. 
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Text Fields 


A text field» denoted by <text> or <nenwtext>» is a sequence of 
characters to be sought or placed in a fite. In most text 
fieids» att characters are significant and any character may 
appear except a specific delimiter. A maxigum of 30 characters 
may be referenced in a text stringe 


sequence Range 


A <sequence range> specifies an inclusive range of sequence 
numbers which define a line or tines’ to be included in Cor 
excluded from) a particular operation. 


Syntax: 


> se eaewwaeaes <s 1> o Pee een ene we se aces eee name ane es we ewewenwnoewen= > Z 
i | t 
Jj «o2ce = 2288228 8 One e ee <s2> sannaea)> | 


{ j 
| --<- END saaannee > | 


Semantics: 


The integers <si> and <s2> represent sequence numberse If both 
<sl1> and <s2> appears the sequence range includes both those 
values and all vatues between, €s2> must exceed <si>. If <si> 


appears alones it usually defines a range coaprising that single 
number. For exceptionss see the individual command description. 
The keyword “END"» when used in syntax in place of <s2>» repre- 
sents the largest sequence number in the file. | 
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Column Range 


A column range specifies an inclusive range of columnse defining 
aportion of a line. 


Syntax: 


eee one @ <col 1> SWOT AAS BeBe Ds eee se Bee ese aaeaoacecasoere=s> f= 
i I 


Semantics: 


The integers <col 1> and <col 2> represent positions on a line. 
Tf both appear» <cot 2> must exceed <col 11>» and they define the 
group of columns including both and all between. If <cot i> 
appears alone» it defines a range comprising that single column. 
A column range may not refer to the sequence field part of a 
Line. | | 


Logical Station Nuaber 


The tLogical station number <lsn> is a unique integer reference 
assigned by the datacoam system to each station in the datacoaa 
network. This value is normally used when CANDE commands pertain 
to stations. . 


re Me ee we me ee Ce ne ee a ee ee Pe oe es ee are Sa ee eee ECS ee ee ee ee ee ee a ent a ee Ee ke ae ee ee ee 
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OPERATING PROCEDURES 


Before a user can make use of the system capabilities» he ust 
first present to the system his usercode and password. If the 
user is using a hardcopy device such as a teletype» the password 
may be typed into an area that the teletype has blacked out. For 
T0830 screen devices» a sacure field is disptayed for typing in 
the passworde 


CANDE checks the user's identification against the system's fite 
of authorized userse. If the usercode/password entered is not 
corrects» the user is informed and asked to re-enter the informa- 
tion. If the usercode/password is corrects» CANDE responds with 
an appropriate message and considers the station to be ae valid 
uSefr e The user cannot use the systea until a successful log-on 
has occurred. | 


LOG-ON —— - 


The user may log onto the system in any one of three ways. He 
may enter his usercode and passwords or he may enter HELLO (Cor 
USER) <usercode><password> and be logged on or he may enter HELLO 
Cor USER) and the system will lead the user through the log-cn 
sequence. : | . 


aa 
et 
Bt 
ato 
zm 
al 
ta 
me 
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The iogron sequence consists of the following steps: 


aes If the user enters a usercode but no passwords the systen 
then responds with: 


ENTER PASSWORD PLEASE. 


For hardcopy terminal devices» the system then blocks out 10 
characters on the next line. For TO830s» a secure video 
field is displayed at the top of the screen. The user 
should enter his password in this fieid. 


De If the system recognizes the usercode and password» it 
proceeds to Step ce {If it does not recognize the usercode 
and password it displays: 


SECURITY ERROR» ENTER USERCODE PLEASE. 


and the Logon procedure begins againe 


Ce On successful log-one the system displays to the user the 
fotiowing: | 7 


B1000 CANDE MARK <RELEASE> VERSION: 

<PATCH LEVEL> C<COMPILE DATE & TIME>) 

USER <usercode> LOGGED*ON AT <time><date> 
YOU ARE AT STATION <LSN> C<TERMINAL TYPE>) 


de After logon verifications CANDE will try to determine 
whether the user*s default pack» as defined in the 
~CSYSTEM)J/USERCODE filer is online. If the user's pack over=- 
ride is not set and the pack is not online» then the user is 
notified as follows: 


YOUR DEFAULT PACK <PACK ID> IS NOT ONLINE 


JCLEETEED PP LESS 


Rosse aapt RSs Sean ian RAR RACH RIMES HOE NARA ecmmerciecameig 
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If the user'*s pack override is set» then CANDE cannot deter- 
mine whether or not the default pack is anlinee In this 
case the user is notified as follows: | 


YOUR DEFAULT PACK OQVERRIDE IS SET- ALL FILES WILL BE 
ON SYSTEM DOISK. 


ee If the user*s previous session had been aborted due toa 
system failure or Line disconnects» CANDE inforss the user 
about his recovery file by disptaying the following message: 
RECOVERY DATA <workfile name> <date> 
Where <workfile nagze> is the name of the recovered file and > 
<date> is the date of the CANDE session recovered. 


Recovery of the indicated workfile is achieved by responding 
with the RECOVER command. 


ENTERING DATA 


Data and commands are entered in the form of messages from the 


keyboard of the terminal. 
SPECIAL CONTROL CHARACTERS 
The following special characters are supported by CANDE: . 


FOR | USE 


endsof“message CETX) control-C or carriage return 
backspace teft-arrow 
line delete 7 7  Prubout or controle 
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Data Identification 


If a message begins with N or fewer decimai digits» where N i 


S - 
the sequence field length of the workfile» it ts assumed to be a 
Ss 


data record and is added to the workfitles otherwise it 1 
treated as a command. 


CANDE Coanands 


The commands used to create and save files» to enter data and to 
perform editing functions are 86700 CANDE compatible cosmands. 
These inputs are processed in serial order» and are queued if 
they cannot be inumediately executed. 


Control Coamands 


Control commands are a separate class of input messages preceded 
by the control coamand characters a question mark ("2"). These 
commands atlow control and interrogation of the user's operating 
environment as explained in a tater chapter. Note that these 
commands are processed immediately and are not queued behind 
other commands from the terminal. 


RESPONSES 


CANDE will respond to every command input by the user. Atl 
commands will receive appropriate textual output as a response 
except for singlewtine entries (see SINGLE“LINE ENTRY)» which 
will receive only a crosshatch ("#") as acknowledgement. 


FILES 


A file is a collection of records of information. It 1s the 
primary means by whicn the user establishes continuity between 
one CANDE session and the next or between CANDE and other 
programs. 


: Bee Ee rad ay Oe ee ee ‘ 2028 ae : . etn : . 
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Filename 

Syntax: 

> @e®weeervrecsecaseanaeceanaanaaaaaaa €file.id> Seneca eee wosewsanaeoeneocoone)> 
j i i | i 
I-~ <multifile.id>/ -->I| I-- ON =" <packeitd> =>! 


A fiiename is used to identify a file in the 81000 systen. To 
access a file through CANDE the user specifies a filename» using 
the syntax of a CANOE command. This filendme say be expanded by 
CANDE and the MCP if the <multifileeid> and/or <packeid> fields 
are not specified. For examples if only the <fileeitd> is speci-~ 
fied» and CANDE tries to access the file» CANDE expands’ the 
filename to “<usercode>/<file.id>” (i.e. the <multifile.id> is 
Set to the usercode of the lLaggedwon user). The MCP then checks 
the SYSTEM/USERCODE file C€see STRUCTURE OF THE USERCODE FILE) and 
applies any default <pack-id>. specifying an * as the first 
character of the filename will cause CANDE and the MCP to take 
the filename as it ts and no expansion will occur. 


A filename field aust be an alphanumeric identifier of 10 or 
fewer characters (with the first character alphabetic) or a 
string delimited by quotes. If the user wishes to refer to a 
filename Cor packname) beginning with a numeral or containing any 
special characters» he must do so by entering the name as a 
string delimited by quotese Imbedded quotes and bianks» however>s 
are not allowed by CANDE. The user must keep in mind that 
certain special characters» such as /» #» Se #£e (» and )» may be 
treated as syntactical “flags™ by CANDE. If the user wishes to 
use these to convey their special meaningss he must place then 
outside the quotes. For examples SAVE AS #*I[&THOU"™ will save a 
file named Cusercode)/{I&THOU on system disks SAVE AS *#IT&THOU" 
will save a file named Cusercode)/*sI&THOU on the user*®s default 
packe 


While filenames are generally allowed to contain as many as 10 
characters» certain command variations may have to add on an 
additional character in order to create a unique names and thus 
must impose a nine-character Limit Csee COMPILE» for example). 
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File Access Privileges 


Any user may access a fiie under his usercode by simply speci- 
fying the <filerid> of the fila. Depending on access orivileges 
deterained by the MCP» the user may also access files belonging 
to another user. | 


For Mark tevel VI.e-1 and higher releases of CANDE» the user shoutd 
refer to the FILE SECURITY product specification regarding 
greater detail tn file naming and access privileges. 


A user backup oprint file is named <userccde>/<#fnuaber> by 
de fault. This fite may be accessed by LIST>» REMOVE and FILE 
coamandss Q@egese LIST #5 will disptay at the terminal the user's 
backup ftle nased <usercode>/#5. This form of the LIST command 
can only be interrupted via the 2?BRK command. 


File Types 
Possible types which may be specified for a workfile are: 


BASIC COBOL COBOL74 DASDL DATA 


FORTRAN FORTRAN77 JOB PASCAL MIL 
NOL RPG SDL SDL2 SEQ 
UPL 


The underlined letters indicate the valid abbreviation for the 
file type. The BASIC» COBOL» COBOL74» FORTRAN» FORTRANZ7Z7>» MIL» 
NOL» SOL » UPL » PASCAL and DASDL types denote files for the 
respective compilers. A type SEQ is an arbitrary data file with 
sequence numbers. A type DATA file is a file without sequence 
number Se File type JOB is used for the creation of WFL files. 
Coluans 1°80 are for texts» and colusns 82°90 are for sequence 
numbers Ccolumns 31°82 are unused). If text exists in columns 
73°80» it is handied in the same manner as DATA files. 


EGE NEE paren tg Pees ge aa a Eg Sed See ee eas eS OE ee te ae ee Raced So cece a Se Ge eee eee ee EE SS ee Sey ER) 
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CANDE uses file type Cas supplied by the user) to describe: 


== where CANOE can expect to find valid sequence numbers and 
what size they are. For example» SDL files have eight- 
digit sequence numbers tn columns 73 through 80 and COBOL 
files have six-digit sequence numbers in coluans lL through 
6 « | 


== the valid variable “caonnector®" spectal characters» to be 
accepted as part of the variable when scanning in token 
modee For examples in the token “A_8" in an SDL file» *_" 
is the connector. | 


t 
Assusged connector characters are: 


"." (Cperiod) for UPL» SEQ and MIL file types 


wer Chyphen) for COBOL» COSB0L74& and DASDL file type 


-" Cunderscore) for SDL» SDL2 and PASCAL file types 


NOTE: CANDE uses the file type as specified in the disk file 
header for the file» unless a type is specified in the command 
syntaxe 


SEQUENCE NUMBERS 


Files to be edited by CANDE must contain sequence numbers. A 
sequence number is defined as a positive integer containing a 
Maximum of eight digits which must appear in the input data 
record. The sequence number may be no longer than the sequence 
field width of that file. The sequence nuaber is used to iden- 
tify the line for editing and to specify the position of the line 
in the file. Except for BASIC files» the sequence numbers are 
not considered to be a part af the data in the file. In BASIC,» 
the sequence numbers are also statement numbers and may be used 
in GO TO and other branch and Loop statements. COBOL file 
sequence numbers are Limited to six digits and are found in the 
first six columns. BASIC file sequence nuabers are five digits» 
located in the first five coluans. | 


J 


a nee el el tl cant ll, 
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RPG also has five digits» located in the first five colunmnse Alt 
other file types except DATA Csee DATA files) have eight digits>» 
found in columns 73 through 30. If in doubt» the user should 
perform a RESEQ command iamediateiy after the GET to insure that 
the file is properly sequenced. Unsequenced files may be 
sequenced by CANDE (see SEQ command). 


Sequence Nuzber Zero 


In either auto sequence and singtlertine entry sode» a sequence 
number zero is accepted and will be the first record sof that 
file. 


ERROR MESSAGES 


Error messages output by CANDE will be one or two Lines in Length 
and wiil be seif-expilanatory. Unrecognized CANDE cosmands are 
answered by “ERROR: NO SUCH VERBS "<input token>** 


DATA FILES 


Files of type DATA are assumed to be 80 characters longs «ith no 
sequence field. When GETting a file of type DATA» CANDE automat- 
icaitly performs a RESEQ using default sequence numbers (Cbase and 
increment of 100). RESEQ creates “pseudo-sequence numbers” tin 
columns 83 through 90 of the file. The file may then be edited 
in a normal fashion. The SAVE command witl remove the “pseudo- 
sequence numsbers"™» restoring the file to its original unsequenced 
State. 


Note: Data files (which ares by definition» unsequenced) cannot 
be inserted into a workfile. CANDE will prohibit such an 
action by the usere 


ef 
ca 
I 
ad 
ast 
eet 
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If any text happens to be in coluans 73°80» CANDE wilt show it in 
a page (Cand will accept it back in a transmission of an editted 
page). The page format wili be as follows: 


Q0O0CO0LOCL columns 1-72 of text ] 


& { cot 73°80 } 

O0C000200f coluans 1°72 of text ]} 
& {C cot 73-80 ] 

etce 


If columns 73780 have no text Care blank)» they will not be 
Shown. Here is a legitimate sanple page: 


NEXT 
00000100 This line has 80 full characters of 
& eeosltext 


Q0000200This tine is shorter 

00000300CSo0 is this line) 

Q0dogd O0400This line 1s ener rere ee ee ee ee ee ee ee ee ee ee ee ee ee es 
g againe 

00000500etc. 

Fa etce 


worcrcncrnranything appearing here will be flagged as an error when 
transmitted. 


wee 


cia 


wot 
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GANDE MECHANISMS 
USERCOOES AND SECURITY 


If executed with program switch 5S set to a nonzero value» CANDE 
uses the file security mechanisms implemented by the MCP. As a 
results users must be aware of the following items: 


ae Usercodes are enctosed by parentheses» and in CANDE'*s 
case are Limited to seven characters in length. Log-on 
is accomplished by entering the usercoede without paren- 
theses. 


be A usercode~password may have a pack associated with ite 
If a pack has been defined» the MCP treats the pack as 
the default pack for files. Consequently» ait files 
will be read or written from this pack. The default 
may be overridden by specifying a pack with the “QOQN" 
attribute in CANDEs or by prefacing the file nase with 
an asterisk (€#) to indicate system diske 


Ce All files saved through CANDE are saved as private or 
public fites according to the user's default protection 
specified in the system usercode file. Private files 
can be accessed only by a program running under the 
Same usercode the file was saved with» or by running 
with a priviteged usercode password. To make a file 
public one must transmit the following message: 2MH 
<filerid> PIN PUBLIC. 


de CANDE has a2 tworway communication with the -MCP. 
Messages are zipped to the MCPs responses come back to 
CANDE and are then routed to the requesting user. 


EXAMPLE $s 


2WY = gives status of only that user's job(s). 

7TD - gives time and date. 

2MX = gives mix for onty that user's job(s). 

PRE CUC)/<filename> - removes the file only if the user- 
codes matchs t1-«@es»7 the signed-on 
owner ts removing one of his own 
files. | 

2M0 - modifies anty files belonging to that owner. 


wane asthe bata Din Sin ASS Aa Aa Bh 1 
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Ge CANDE displays» on the terminals» printer backup files 


which have been created by jebs executed through CANDE. 
Backuo files are locked in the disk directory with a 
name of the form <default pack>/Cusercode)/#<number>. 
Tne command LIST #<number> brings the backup file to 


the screen for review. If CANDE is not executed with 
file securtty» then RJE FILE NAMINGs FILE SECURITY» and 
MCP communication are not provided. This means that 


backup files will not be created autogmaticatty nor wilt 
they be named as above. 


STRUCTURE OF THE USERCODE FILE 


The 6e1 and later releases of the MCP support a file security 
mechanism for disk fites. This means that disk files created by 
CANDE when it is running with file security» have security 
restrictions enforced on them. Usercodes and passwords are main- 
tained in the CSYSTEM)/USERCODE file created by SYSTEM/4AKEUSER. 
For amore cormpliete discussion of the usercode file and the 
SYSTEM/MAKEUSER programs see Pe Se 2219 0102» B19000 EILE 


SECURITY. 


SYSTEM/MAKEUSER is a utility programs used to create» access or 
modify CSYSTEM)/USERCODE» the system usercode file of ailowable 
usercode and password comoinationse The information for each 
usercode 1s described below. The fields are catitled "“usercode 
password entry attributes™ and are used to control the jobs and 
files of users. 


Field Description Sample Input 
Usercode 7? characters US=<7 characters> 
Password 10 characters PW=<10 characters> 
Packeid 10 characters PACK=<10 characters> 
Charge nunaber 24 bits CHG=<6 digits> 
“User priority J 4 bits PRI=<2 digits> 
Protection 3 2 bits PUBLIC 
Priviteged bit 1 bit *PRIV 
In the preceding tables ail descriptions indicate a maxiaua 


length for the input. *PRIVY will set the privilege bit in the 
"on™ positiane 


pl 
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Each card should contain one unique usercode-password pair» a 
packeid (Cblank defaults to system disk)» a charge numbers a 
oriority number» and a privilege status indication. The card is 
in free format» with blanks delimiting each item. The maximun 


number of usercode=password combinations is 1024. A blank 
pack.eid is denoted by PACK = **, 


SYSTEMZMAKEUSER EXECUTION 


To create the system usercode file a card deck in the following 
form must be presented to the systes: 


EX SYSTEM/MAKEUSER; 

DATA NEW/USER.CODES 

<usercode entries as defined above> 
ENDs 


ey on 


on 


or 


EX SYSTEM/MAKEUSER> 

FIL CARD NAM X DSK; 

where X is a CANDE“created file of 
type DATA. 


ey ag 


The file will be automaticaily created» listed» and placed in the 
appropriate name table slot. For more information see 


Pe So 2219 01025 91000 FILE SECURITY 


CANOE EXECUTION 


The 81000 CANDE program runs in conjunction with an NDL“generated 
network controller. The network controller can be running while 
CANDE is executed» initiated during the CANDE executions or 
starting with Viel release» initiated after the CANDE execution 
during the first remote file open. To use the current network 
handler» the user executes CANDE as shown previousty. To invoke 
a network controlter while executing CANDE the user aust enter: 


EX CANDE SWO0=1 


This causes a network controller named CANDE/HANDLER to be zip- 
executed. To invoke the network controller at the first remote 


Vineet gente te Abin Nimat RR 8 : ee ate oe te Ae sek atte aM AD 
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file apens the name of the desired controller is placed in the 
name table by the MCP option: 


CM C<networkecontrolier-name> 


If the controttler was executed by the MCP from the *C* stot in 
the name table» and the Last remote file close has been oproces- 
|  ged»s the MCP will queue a *QC* for the network controller after 3 
times through "N.-SECOND*® Cabout 1 minute with a mix of i) with no 
intervening remote file opens occurring. If the controller was 
locked Cexecuted with "PT* of "PROTECTED® or modified thus or 
<MIX>LP was entered) the *QC* queued by the MCP will be 
per formed. Any attempt to Q@C or OS from the ODT white the 
handler is "tocked* wiltl be denied. 


Since the Mark level IX.0 releases running CANDE under a usercode 


has no effect on file security. The one resaining advantage of 
running CANDE under ai usercode is so that alt of CANDE's work= 
files wiil be on the default pack for that usercodee This ts 


particularly useful for instaditations that have probiems with 
running out of space on system diske 


CANDE's workfiles may also be file-equated to any user pack. 


Notes If CANDE/ANALYZER is used and any of the CANDE files WORK» 
RECOVERY or AUDIT are not on system disks then CANDE/ANA- 
LYZER must be executed in the same manner as CANDE 
Cexecuted under the same usercode as CANDE or with the 
workfiles filetequated to the same user pack as CANDE*‘s 


wer@)e 
CANDE FILE 

INTERNAL NAME FUNCTION 

CONTROL | MCP ZIP COMMUNICATION 

WORK | MASTER WORK FILE Csee WORKFILE) 
TEACH_FILE TEACH INFORMATION 

CMO0_Q_ FILE QUEVED COMMANDS Cduring *SAVE™>» 

"INSERT *» etce) 

PAGE_FILE COPY OF EACH USER*S LAST PAGE QUTPUT 
RECOVERY MASTER RECOVERY INFORMATION Csee WORKFILE) 
AUDIT AUDIT FILE Conly in use if *ME™ is 


| | greater than or equal to 5760) 
MCSQUEUE REMOTE FILE 
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DISK PACK DEFAULTS 
| 
Since the MCP will force files to a default pack assoctated with 
the usercodespasswords syntax has been implemented to access 
files on system disk if a pack was specified in the userccde- 


password table. The foilowing tadle appties to ati commands 
aflowing filenames. 7 


orfrw 


ENTER PACK .ID FAMILY .ID FILE.ID 
A DEF «PACK CuCc) A 
A/B DEF -PACK A 8 
A/B ON C c A B 
CUC)/A DEF .PACK Cuc) A 
CUCI/A ON C C CUC ) A 
#CUC)/A Cuc) A 


2A | A 


An asterisk entered preceding a. filename denotes that the fite is 
on system disk» and CANDE Looks for a Literal name foilowing the 
asterisk. 


WORKETLE 


CANDE can be directed to read any file which the user may access» 
however.» changes may be made only to the one file which ts cailed 
the “"“workfile"™. The user gets anew workfile by doing a MAKE» or 
he may recall an existing workfile by doing a GET.j£ Additions and 
corrections may be performed on the workfite by singlertine 
entries or by using the editing commands. 


A CANDE workfile may consist of one or two parts. The first 1s 
the user's original source file» present only if a GET ts done. 
This file is never modified by userediting. It wilt be removed 
and reptaced by a complete» edited file when the user enters a 
"SAVE". 


The second part of the user's workfile consists of portions of 
CANDE*s master workfile Cnamed “CANDE/WORK.FILE”") assigned to the 
user This contains added and changed records which modify the 
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user's workfile. This master workfile is organized in a randos 


fashions» access being directed by a set of tabtes for each user 
contained in the RECOVERY file. These tables also note deleted 
workfiie recordse 


A SAVE is required to make the workfile a permanent file on disk 
in the user's tibrary. When this is done» the master workfile 
entries and tables are flushed. ) 


PATCH MODE 


Because a SAVE of large files is time-consuming and because sost 
compilers will merge source and patch files at coapile times 
CANDE has mechanisms to encourage SAVEing only those records 
actualiy edited as a “patch” file separate from the source fite. 


If CANOE is given indication that the user intends to end his 
editing session by entering a "SAVE AS <filename> <:PATCH*™>» the 
user %s prohibited from entering certain commands which wouid 
flush his portion of the master workfile. These commands include 
SAVE Cwithoqgut sPATCH specified)» RESEQ and also MERGE» RMERGE and 
INSERT if a targe number of master workfile records witl result. 
As a cue to prohibition of these commands» CANDE tlooks at the 
user*s patchrid field which it maintains. If this fietd is not 
null» the user is assumed to be in "patch mode”. By default this 
field is null unless: 


- The SPATCH coamand is used (without a sequence range) to 
set the field. | 


- The sPATCH option of GET is used» in which case CANDE sets 
the patchrid field to “*blank"™>, which is distinct frogs 
"null. 


A "prohibited™ command may be forced by setting the patch-rid 
field to nuil. This 1s done iby entering "SPATCH 
<delimiter><delimiter>*”. However» the user should not then use 
the sPATCH aption of SAVE as he wilt not obtain the desired 
result. 


For other details oan “PATCH MODE» see GET» SAVE and SPATCH 
commandse | 


coed 
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RECORD MCOIFICATION 


If a file is present (Ca GET» MAKE » ocr RECOVER has been 
processed) » the user is assumed to be in a state of aditing the 
filee Any input consisting only of records having valid sequence 
numbers with no sequence errors will be treated as records to be 
entered into the file. After the input is processeds a NEXT will 
be performed automatically» meaning that the next page will be 


displayed» beginning with the record that follows the last one 


inpute 


PAGE» LIST Cexcept from an externai file)» BACKs SAME» NEXT» ~» 
and + explicitiy request a page to be displayed. For CRT devio- 
cese records may then be edited and the page Cor partial page) 
transmitted back. For nonCRT devices» the records must be 
retypede : 


For recovery purposes» CANDE will not clear the screen at tog-an 
time. The user may recover his file and transait to the system 
any records teft on the screen at failure time. 


The 1s920“byte buffer used by the PAGE system has been soved fron 
dynamic meswory Cif present) to static semory in CANDE®s basem 
Limit. It is used to *rotlin™ a user's Last output tin order to 
compare the current input against ite Comparison wiit atlow the 
system to determine if arecord has changed so that it wilt oanly 
add to the workfile those records which have changed. This is 
necessary to prevent writing unnecessary records to a file when 
the user initiates a SAVE :PATCH. It also makes input processing 
more efficient. | 


Comparison occurs recordby“record only when the sequence numbers 


are the same. If a sequence number is encountered in the tnput 
which does not exist in the last output copy» then comparisan 
wiid cease and the record witl be added. Processing witt 


continue in this fashion until either the sequence number of an 
input record is greater than or equal to that of the tast output 
record at which comparison ceases or all input records have been 
processed. This prevents the occurrence of unnecessary error 
reports or “advisories". Also» synchronization of record compare 
ison will not be lost and no unchanged records will be added to 
the workfile. If the page of input returned to CANDE is missing 
any records initiatly displayed Cuser has performed a tine deiete 
locaily) the missing records are not autonmaticatly deleted fron 
the workfile. 


) BURROUGHS CORPORATION | COMPANY CONFIDENTIAL 
: COMPUTER SYSTEMS GROUP B1000 CANDE 


SANTA BARBARA PLANT PeSe 2212 5561 CH) 


LINE QELETION 


Single Lines may be deleted through use of the votd command. ‘*V" 

must be the first character of the Line and the line must contain 
a valid sequence number. Any number of blanks» or none at ail, 
/ May separate the command and the sequence number. If the 

sequence number is tn errors the record wilt be treated as a 

sequence error (Csee GENERAL CONSIDERATIONS). 


FILE POSITIONING 


CANDE atlows the user to move backward and forward throughout the 
file» once PAGE or LIST is invoked. PAGE or LIST in any foram 
cause the file “position™ pointers (€ for BACK» SAME» NEXT» - or +) 
to be realigned to the requested position. For CRT devices»s 
after displaying a page» NEXT will be written at the home pasi- 
tion teaving the cursor immediately after ite Thuse transmission 
without moving the cursor wilt effect NEXT automaticatly. Any 
other string transmitted in the first line is treated aS a 
command inpute If transmission includes more than the first 
line» then it is assumed to be tnput records> the first line is 
ignored and the input is processed. 


File positioning ts controlled through the following commands: 


BACK <n> : Display current “<n>th page. 
SAME 2 Display current page againe 
NEXT <n> 3 Display current +<n>th page. 
- <n> : Display page at current ~ <n>th record. 
+ <n> : Display page at current + <n>th record. 


Notes A missing <n> tmplies <n> equals one. 


Inmediatety after GET or MAKE or RECOVER» these commands CBACK> 
SAME» NEXT» -» and #) will be treated as if they were LIST. 
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Pius or minus <n> (#<n>» *<n>) shift exactty <n> records in the 
direction requested. BACK <n> and NEXT<n> shift approximatety 
<n> pages in the direction requested. In this way» BACK and NEXT 
may be used to position the file approximately to the desired 
area quickly without reading through each record on the way (from 
the current positicn to the requested onee Once in the approxi- 
mate area» the user may adjust the position accurately by using 
+<n> and “<n>. The range of records shifted is 1 «= r <= 131071 
where r=n for plus and minus and r=ntcurrent pagesize for BACK 
and NEXT. 


To effect “approximate” shiftings a factor indicating an estimate 
of the increment between successive sequence numbers 1s coaputed 
at GET time or upon entry of SEQ or RESEQ command and dynamicaily 
adjusted for tacat variation during accumulation cf records for a 
display. The inittal computation of the factor at GET time witl 
be more accurate tf *CHECK is specified. A moving average is 
comaputed during sequence checking on the file. If sNOCHECK is 
specifieds the factor is computed by dividing the difference 
between the scurce ending sequence number and the source begin- 
ning sequence number by the fite sizes. At SEQ or RESEQ times the 
INC (Cdefault or specified) is used unless a sequence range is 
specified indicating tocal activitye If so» the factor is not 
modified. 


RECOVERY 


Recovery of a user's. workfile occurs when CANDE is executed after 
an abnormal termination or when the user’s terminal tnecurs 
consecutive retry ttmeouts. The recovery procedure itnvolves 
creation of the recovery file and communication of this fact to 
the user when the user logs one The recovery file ts named 
<usercode>/ RECVRY9I0O<AB8>. <A8> 15 a unique two~character 
sequence computed as follows: 


Cusercode index/36)th character of ATOM Csee below) 
Cusercode index mod 36)th character of ATOM 


P aa 
ol 


ATOM = ABCDEFGHIJKLMNOPOQRSTUVWYZ0123456789 
Character *A*® is character 0 of ATOM; 
Character "9* is character 35 of ATOM, 


This scheme produces a unique recovery fiie for each usercode/ 
password pair. To avoid loss of the fite upon recovery» users 
should not intentionally create files named in this manner. 
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After log-on each user that was on the system when it aborted has 
the option of recovering his workfile. The user enters RECOVER 
if he wishes to get his previous workfile. If the user does not 
wish to recovers he merely starts another session. When a system 
goes downs it is passibie to lose a few of the most recently 
entered workfile records. 


Notes The CANDE system must always be executed tn the same way 
every time if recovery information is to be preserved and 
accessible. This only appiies to fite equates and whether 
or not CANDE is executed with file security. 


In order for a recovery file to be found at LOGON» the 
user*®s usercode index must be the same as it was at the 
time the failure occurred. To ensure this conditions do 
not create or delete the CSYSTEM)J/SUSERCODE file when there 
are users which need to recover. 


DISPLAYS AND ERRORS 


~ 


TERMINAL PAGE will correctiy set page size as requestede. See the 
TERMINAL command section for default page sizes depending an 
terminal typee 


ALL displays to a device having a page size greater than one will 
begin on the second tine of the screen and end with the cotuan 
indicator on the last line. 


Any tine whose first token is a valid CANDE command wiil be taken 
as a new command and executed after the records to that point 
have been processed. (See LINE DELETION for exceptions.) 


Att numerics in sequence fields indicate to CANDE that after 
input is processed» the next page should be displayed. 


seguence errors are defined as: a) numeric but out of sequence 
or 6) beginning with a nonenumeric which is 1) not a valid CANDE 
verb and 2) not V (See LINE DELETION). The action taken ts to 
leave the screen alone and notify the user on the top line of the 
screen. R 


4-11 


BURROUGHS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP B1000 CANDE 
SANTA BARBARA PLANT | PeSe 2212 5561 CH) 


The message "NOTE: SOME MESSAGECS) WERE LOST SECAUSE THE QUEUE 
TO YOUR TERMINAL WAS FULL" will be given to,the terminal whose 
pending output is enough to overflow CANDE*®s remote file 
MCSQUEUE. Gverflowing messages are discarded by CANDE. The 
message appears cne command late (Cit refers to the next ta the 
last comand executed). 


Inserts are defined as: nuabers in sequence but not put on the 
screen by CANDE.j The action taken ts to add the record(s) to the 
workfite and discontinue comparison against the copy until the 
next copy sequence number is encountered. 


For devices whose page size equals sonep the foilcwing operating 
characteristics are valtds 


= Break key (Ctetetype onty) will clear the output queue 
and terainate. 


= SEQ» when it displays an existing record» wilt CR» 
(CR=Carriage Return)» LF» and re-type the sequence 
number» teaving the carriage immediately after the 
number to allow the tine to be changed and re-entered. 
If only an ETX or CR is returned» the record witt not 
be changed and the command will continue. If #t was 
not an existing record (only a new sequence i nuaber) 
then returning oanty an ETX or CR will terminate the 


coamand. 
= PAGE will treat displays as noted above in SEQ. 
= LIST will not be paged but will be continual. 
= BACK» SAME» NEXT» = » and + wtit be operative. 


- V will not be operative. 
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CRI-IYPE DEVICES 


Pages output to a CRIwtype device witl be preceded by ‘*HOME AND 
CLEAR® and witli have CR appended after the rightmost non-bdlank 
character in each line in order to decrease transmission time 
Since the remaining blanks wilt be deleted. If the line is 
blanks it wilt consist of CR onty COR = carriage return). Single 
line output to a 1T0820/830 series device will have LC appended to 
it in order to clear the remainder of the Line (LC = clear to end 
of tine}. The terminal is always left in receive aode after 
output except on a page to be edited. 


SCROLLING 


The NDL library requests CANDEPOLTD» CANDEFSLTD and CANDESELTD 
contain a scrolling capability available to users running under 
CANDE and those running an apptication program under CANDE. 
Scrotling is disabled by default. Enter 77+" to enable scroiling 
and “?"" to disabte scrolling. 


Atl output except full page output produced by LIST» PAGE» SEQ is 
written a singte line at a time at the bottom of the screen after 
shifting the screen up one tine Cthe top line is deleted). Any 
input except paged input is scroited to the bottom of the screen. 
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COMMANDS 


In the table belows CANDE commands are grouped by function: 


Control Cosmands: 


Editing Commands: 


DELETE 

FIX 

INSERT 

ME RGE/RMERGE 

MOVE | 

PAGE 

RE SEQ 

SINGLE“LINE ENTRY 


Editing Mode Commands: 


MARGIN/@ 
SEQ 


Environment Commands: 


BYE 
DCSTATUS 
FILES | 
HELLO/USER 
PASSWORD 
TEACH 
TERMINAL 


Input*Output Coamands: 


LIST 
WRITE 


Program Execution: 


COMPILE 
EXECUTE/RUN- 


Search Commands: 


FIND 
REPLACE 


Workfile Commands: 


GET 
MAKE 
RECOVER 
REMOVE 
SAVE 
SPATCH 
TITLE 
WHAT 
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The BREAK command terminates the current command in process. 


Syntax: 


Semantics: 


<preak key> 


All output queued for the terminal is “flushed” when the BREAK 


command is processed. 


Use of the break key {aon a teletype) wiit 


terminate FIND» LIST» and REPLACE commands only. 


Coamands during which a break will be accepted: 


FIND 

GET 

INSERT 

LIST 

MERGE /RMERGE 
MOVE 


PAGE SPATCH 
RECOVER WRITE 
REPLACE 

RESEQ 


SAVE 
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BYe 


The BYE command terminates the user's current sessione 


Syntax: 


Semantics: 


A CANDE session is terminated by the BYE commands switched Lines 
may be disconnected. If the workfile has not been saved or 
removed» the user is notified of this condition. The workfile 
may then be removed or saved» and the BYE command re~entered. 

When BYE is entered» CANDE checks if the station has a secondary 


file Can MCS) present to which it can be attached. If soe the 
Station is automaticaliy detached from CANDE. 


Example: 


BYE 
USER <USERCODE> LOGGED-OFF CANDE AT <TIME & DATE> CTIME = <HHSMM3SS3T>) 


Note: Time given is CANDE processor time (See Appendix A). 
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COMPILE 

The COMPILE command invakes the standard system compilers or any 

nonstandard version. Options provide the ability to use an 

existing file or workfiles» to specify the object filenanes to 


specify the compiler name» and to specify the Label equation and 
other controt statements for both the compile and resultant 
object program. The maximum Length of the COMPILE command is 80 
char acterse If the user has a workfile present» any cosgmand 
entered targer than 80 characters is expected to be a page. 
fherefore a sequence error wouid be generated for the second = and 
subsequent lines since it is not a valid sequence number or a 
CANDE coamand. 


Syntax: 


COMP ILE OO OOS 82888888288 ABA ABAD H DTH AYSB BOT 88822 De Ae eee >> 


j 1 
[ < wow eseeeamnaeeesenesenasanemaaaaan| [Cet essere esoss cena | 
11 i 
I-/1\~ <source filename> eerrrerrr=">| Ilo- + <modifier> -->1 
I | 
le/1L\" AS sete" <odDject filenaae> ->! 
i i { { 
i i-3-! | 
j | i 
i-/1\-° WITH <compilername> =°--°7->->! 


Semantics: 


If <source filename> is not specified» then the workfile will be 
used as the source file. If the object filename is not provided» 


then the source filename wilt be used. In either -case» an "QQ" 
will be attached to the end of the fileeid to flag the file as an 
object file» unless "$" is specified before the <object 


filename>. 
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A compiler must be specified if the source filename given is not 
the current workfile. Also» a compiler should be given if the 
user*s workftle is of a type DATA or SEQ. If no compiler is 


givens the UPL comptler will be the default. 


Examples 


Compile the workfile using the defauit compiler type and assoa- 
Ciate the object file with the workfile. 


COMPILE A/B AS D WITH SOL 


Compite the source file A/B as object file <usercode>/D0 with the 
SDL compiler. 


C WITH MY/SPECIAL/COMPILER compiles the workfile using the spec- 
ified compiter. 


C as $F compiles the workfite;, object filename is literaily 
<usercode>/F with no "0" concatenated. 
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CLEAR Queue 
Syntax: 


2?C Q OOD 2H BRA 2e O88 82 28818222282 e CBB eZewZee Ben eee seaee > f 


Causes ait pending output to a terminat to be cleared to a 
maximum of "MAX MESSAGES* as defined in the network controller 
dectaration sectione 


NOTE: If CANDE*s remote file MCSQUEVUE gets filled to a maximum 
Of “MAX MESSAGES*"» and is unable to empty itself to the appro- 
priate terminals any remaining messages will be discarded. In 
additions the user will get a message» "NOTE: SOME MESSAGECS) 
WERE LOST BECAUSE THE QUEUE TO YOUR TERMINAL WAS FULL™ upon the 
next coamand entered. 
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DCSTATyUS 


The OCSTATUS command provides general information regarding the 
status of the users statione 


syntax s 


Semantics: 


DCSTATUS witli return to the user a rundown af the user*s station. 
The following are returned to the user: 


LSN 

NAME 

TERMINAL TYPE 
BUFFER SIZE 

MAX RETRY 

INPUT PRIGRITY 
OUTPUT PRIORITY 
MESSAGE COUNT 


bse mates 
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DELETE 


The DELETE command discards records from the workfite. 
Syntax: 


| woe we eeneeeoe see ALL ee eeaweseeooraerea) } 


Semantics: 


Those lines specified in the sequence range list are deieted from 
the workfile. If "ALL" is specified» the entire contents of tke 
werkfiile are deleted» but the name and other attributes are 
preserved. 


Examples: 


DEL ALL 


Delete the entire contents of the workfile. 


DELETE 100-500 


Delete tines 100 through 500 from the workfile. 


DEL 200-END 


— 


Delete lines 200 through the end of the workfile. 
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O5 


The DS coamand discontinues the current running users remote 
program that was executed from CANDE. 


The ODS capability applies onty to jobs which have successfully 
performed a remote file OPEN Csee Appendix A). CANDE obtains the 
job-number of the user program> the job may be OSed by entering 
"705" from the terminal. Refer to the ?<MCP CONTROL SfRING> 
command for DSing jobs which have not opened a remote file. 


syntax: 


food 
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EXecure 
RUN 


The EXECUTE and RUN commands cause execution of an object 
program, the RUN command always provides for compilation of the 
source file before executione 


Syntax s 


RUN PO 8 8 8 8 8 OS 8 8 OO 8 08 8888 ODT Te DBD Bee BATT eH eweeeeewweae) f 


=<. = 1 | J | Cece ce ewe ese oceeoceace cea j 


Dad 


t jem <filename> -->1 {t-- + =" <aodifier> -~>] 
j 
EXECUTE oswewoonn{ 
= i i 
I- & =>} 
I- # => 


Semantics: 


The workfile is assumed tf no filename is provided. A "2" is 
specified only with EXECUTE» and indicates that the actual file- 


‘name of the object file is the filename following the “*". 


An object fite created by CANDE is named with the source file 
nane suffixed with the tetter Oj If "$" is specified» CANDE does 
not assume that the specified object file has the 0 suffix. 


A <filename> in EXECUTE may refer to any file to which the user 
is permitted access» but a <filenamwe> in RUN must refer only toa 
the user’s current workfite. | 
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Modifier specifications may be provided. 


Exaapies: 


EX 


Execute the object program associated with the workfile. 
RUN » FI LINE = REMOTES 


Execute or compile-and-go on the workfile name and tabet equate 
the output to the user's regote terminal. | 


If a program executed by CANDE opens a remote file» CANDE witt 
specify 7%?" as the signai or escape character in the approval of 
the open. This means that a "%?" as the first character of input 
will be interpreted as a request to direct input to CANDE rather 
than to the executed prograg. For this reason» users should not 
run terminat programs which make use of the "?" as the first 
character of input under CANDE. 
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FILES 
The FILES command provides a method for deteraining if a fite is 
on diske 
syntax: 


FILES 22288 2828222 AODBABDDEADADDBEBDADEBHABDABAB A228 <filename> aseovaae= » § 
i jo= & o>] i 


{ i 
joe2c2c7re OBJECT eweneewoooewoeo=e > | 
== =. on ] a 


{-- $ ao=> | 


Semantics: 


The FILES coamand will search disk for the specified filename and 
report whether or not the file ts oan diske If the file is 
present» that fact is reported along with some general inforaa- 
tion about the file. The GBJECT parameter allows the user toa 
Search for cbhject files created through the CANDE COMPILE or RUN 
commands. {i1e@ee the file.-itd of the specified filename is 
changed to <fileeid> CAT "0"). Systea object fiies or object 
files not created through CANDE may be found by using the normal 
filename syntax and omitting the OBJECT parameter. The “2 
aitows for inquiries on files not created by CANDE. The *$* 
indicates that the %°0" suffix should not be added to an object 
filerid. 


i 
fae | 
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The following is returned to the users terminal when the specified 
file is found on disk: 


FILE <filename> PRESENT 

USERS = <integer> CO-n) 

TYPE = <file.type> CCODEs DATAxr.acocetCe) 
SIZE = <integer> CEOF pointer of file) 


BLOCKING CRSZ/R~B/BeA/ARED = <integer>/<integer>/<integer>/<integer> 
| CRECORD SIZECbytes)/ 
RECORDS PER BLOCK/ 
BLOCKS PER AREA/ 
NUMBER GF AREAS) 
CREATED =: <date> Cmonth/day/year ) 
ACCESSED: <date> | ; Caonth/day/year ) 
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FIND 


The FIND command searches a fite for appearances of specific 
texte. Qutput indicating the result of the search may be directed 
to the terminal.» The cutput of a FIND is prompt drivens that is 
the command will fiit a screen to its page size and then the user 
must transmit a character to get the next page of output. A 
"7BRK" will break the output as soon as possible. 


Syntax: 
FIND Pee YY Y cy + Y + yt ty yt hl hth <€<deliao -— 2 <€text> —_ «2 €<delia> =-— >> 
i ft) | <oce ee coe ewe oececea | 


I- IN 7 <count> ==> 
] H 
j- /iN 7° LITERAL ==>! 


> > Pe 28 8 O88 ee BOSE TBE Be 2 Ce CB ewe Demo e eee weet es enwaee zaeew > J 
jC ce eewoewec cece ee wawec es eee sees wee we cme woo wae eaneccoa= | 
j-- iN am a. <filename> se ewes ene ece ae nee eens ewaanawae=) | 
l-- <type> -=>1 
j 1 
j-= JIN —--a <sequence range> Se cen awww es ens eas aaaneawe) | 
i | | i 
j-= LIN <2 an =e 2 <coluan range> awe ene eee ee ees eew seen en) } 
j | i 


i [ < eee ee eee ee ee ewes eee eee et esas eet eee | 
i t j 
j°-=- JIN aa 5S wee iN =<. TEXT Seana ne ea ecen wa nawaneeeaen > | 
i i 
j-- iN -— = FILE Sean nnoas <filename> o=> | 

! ! 


j-- x =>] 
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Semantics: 


Gniy one target may be sought with a FIND. The delimiters 
surrounding the target may be any delimiter. The text may 
contain any characters except the delimiter. The text fieid may 
not be empty. The text field is treated as a token string unless 
LITERAL is specified. 


The search is successful whenever the string of characters in the 
text fietd is found in a line of the file. 


If the integer <count> appears,» the search for the associated 
text wilt be terminated after it has been found in the specified 
number of times in the file. 


If a <filename> is not specified» the workfilte is searched by 
default. Specification of <filename> causes searching of the 
specified file» which may be any file the user is allowed to 
read« A <type> may be specified to give the tocation of sequence 
numbers in relationship to the text. If no <type> ts specified» 
the file type ts as specified in the disk file header for the 
file. If a sequence range is specifted» only records falling 
within that range are searched. A coluan range» if provided» 
indicates that only a specified part of each record is to be 
examinede Note that a column range cannot fall within sequence>- 
number range (Ceeger columns 73 through 80 for SDL files). 


CAS Gna a Teh etre AAR ED ves Se sha N aS ais Ses SIR Ra aa 
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The option :TEXT» if specified» will output the entire Line 
containing the string to the user's terminals» otherwise only the 
sequence numbers of those records containing the string are 
output. The option sFILE <filename> will direct output from the 
FIND to a disk file labeled by that name. If the opticn FILE = 
<filename> is used» the file is forced to the system disk and not 
ailowed to go to the defauit pack associated with the usercede 
{refer to VI.I security implementation for CANDE). The defaults 
for sequence range and cotumn range are the entire file and the 
entire records respectively. 


Exaspless 


FIND / FILEID / 100-900 


Search the workfile fer the occurence of * FILEID " within the 
lines 100 through 900 and output any iines found with the text to 
the terminal. 


FIND 10 / STUFF / 


Find the first 10 occurences of * STUFF *" within the workfile and 
output the sequence numbers of the records containing the string 
to the terminal. | 


FINO LIT /X/ s:FILE #@ X 


Find aft occurences of the titeral °X" in the workfile and put 
the records containing this string into a file named X on systen 
disk. Also output the sequence numbers of the records Sonavnens 
this string to the terminal. 
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Fix 


The FIX command alters the contents of atline in the workfiles by 
inserting new text or replacing part of the Line. The alteration 
may be controlled by specifying target texts» column nusberss or a 
combination. 


Syntax: 


o- | 1 
l-"-- <column range> <--->! 


>>ew= <delim> <text> <delia> <newtext> serectesreserescecsenn=>F 


Semantics: 


The variable <s> is the sequence number of the line to be maodi- 
fied. If there is no such line in the file» the command ts 
disregarded. 


The <colusan range> may indicate one column or moree If the range 
refers to more than one column» the beginning and the ending 
columns are separated by a hyphens e.ges 1°54 If column range is 
1s unspecified» the whole record is taken as the target of the 
fixe When the change has been made» the changed record is 
displayed. 


The semantics vary for several foras of this comgands depending 
upon the presence of column numbers and text: 


If <text> is givens the specified tine is scanned from left to 
right for a literal appearance of the character string specified 
as texte If coluan(€s) are specified» this scan is only performed 
on the colusgn(s) indicated in that line. If the <text> is found 


Ce 
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theres the target <text> is replaced by the character string 


specified as <newtext>. If the target is not founds the FIX is 
disregarded. Onty ane replacement is made on the tines per FIX. 


If <text> is not givens then tf no columns are specified»s the 
<newntext> replaces the entire line» with zero fill at the right. 
If oniy one colugan is specified» the <newtext> replaces the char- 
acter in that coluane If a range is specifted»s the characters in 
<left column> through <right column> are replaced by the newtext. 


The <text> and <newtext> aust be deliswited by a special char- 


re ee en a ee ee 


actere The <text> may contain any characters except the delinz-~- . 


iter. Ail characters» including blanks» are significant in the 
<text>s the <text> field is eapty only if the two delimiters are 
in adjacent columns. 


The <newtext> field begins after the second delimiter and runs to 
the end of the record. Blanks are significant>s <newtext> is 
empty if the end of the record tamediately foilaows the second 
delimiter. 


If the size af <newtext> is greater than the size of the string 
being replaced» then the characters in the record to the right of 
the string being replaced are shifted right to make rooa (fer 
<newtext>. This may cause overflow. If the size of <newtext> is 
less than the string being replaced» the characters to the right 
in the string are shifted teft. | 


There 1s considerable function overlap between the FIX and 
REPLACE commands. FIX is specialized for single replacements on 
single lines and has avery concise syntax. REPLACE is more 
generals» with file~searching and output capabilitys its various 
options require a more elaborate syntax. 


If acolusn number outside the <text> field is specified» or if 
the beginning column exceeds the ending colugns the FIX command 
is rejected. 
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Examples: 


FIX 398 1°39 /AB/ABB 

This locates the target text "AB" within columns 1 through 39 of 
Line 398 and replaces it with "A887. 

FIX 500 /ENO>/END ELSE 

This locates the text “"“ENDs" within Line 500 and reptaces it with 
"END ELSE*. 

FIX 10 40 //2Z% ADJUST LINKAGE 


This inserts new text» "Z ADJUST LINKAGE”» reptacing the char- 
acter in column 40 of Line 10- 


FIX 2 1°5 // <end of statesent> 


This deletes the first five columns of tine 25 shifting the rest 
of the image to the left. 


We gem ate eee me ae oie er ee ee a Les Se nn kere cere ean Mer ken aa ey Mt 
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Gt 


The GET command recalts an existing file as the workfile. if the 
UNSAVEd workfile already exists» the GET command is in error. 


Syntax: 


GET SQ2Wenneanaae <filenaae> OO 8 C8 CORO O28 ORO 8 2 Oe 28282882 222222 e222) > 


- | i H i 
i7-- « =>] | j-- <type> -~->1 


> pe ne nt ern nn nn a en een en nn ene e ne cence ne eeesnsesrcern==>}# 
| 
[2-3 222" NOCHECK sone nenee nese eneer----"->] 
i o-< 
l-- CHECK s<2-ees ees nn nnn nnnnncen-=-=>] 
i I 
bm" PATCH secs nn snes nncenceeeeesns--->) 


| «cer wee ocecoa <file-id> aw=> ]} 
i { 


|-- & =>] 


Semantics: 


The <filename> may specify any file to which the user has access. 
The GET gives the user a copy of the file so that he witl not 
alter the original file. The <type> specifies the file type of 
the file being Loaded and wiil dictate where the sequence numbers 
are placed in relationship to the text. If <type> is oamitted>» 
then CANDE uses the file type as defined in the disk file header 
for the file. If the file is one that was created by CANDEs the 
file wittl be propertly sequenceds but if the file was not created 
by CANDE» the user is responsible for sequence errors. If "#" is 
specified» only the literal name after the “#" is sought (refer 
to Viel sacurity implementation for CANDE). 
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The options NOCHECK and CHECK provide for performing sequence 
field checking during the get. NOCHECK is the defaults» in 
keeping with prevtous reieases where NOCHECK its the only optian. 
CHECK performs sequence checking on the file. 2éequence checking 
may be terminated early by entering ?7BRK Csee the BREAK command). 
The file will be marked as Loaded with no errors. Any errors 
beyond the BREAK will be detected during operation on the file if 
those records are accessed. , 


The PATCH ootion allows the user to reload a patch file created 
by terminating a prior session with "SAVE AS <filesid> <sPATCH®™ 
back into his portion of the master workfite. He may then 
continue editing as though it had been one continuous sesstone 
Specifying PATCH with no filename simpiy aodifies the patchrid. 
field to blanks»s thus signailing CANDE that the user intends 
eventuaily to "SAVE AS <filername> :PATCH™ Cthis 1s alsa done 
when a filename is specified). , 


If a user loads source files to system disks and those files have 
oniy a single filename» that user may edit those files using 
CANDE.j The user enters on the terminal GET #*<multifite-id><file- 
type> and CANDE witt load the fite for editing. When the file is 
Saved without specifying the AS option of the SAVE command» it 
will be saved under that user's usercode as <usercode>/<nage 
specified in the GET conmmand>. 


Exaaples: 


GET AFILE 

This loads an existing file named <usercode>/AFILE as the work=- 
file. The type is the type as defined in the disk file header 
for the file. . | 
GET AFILE FORTRAN 


This loads an existing file named <usercode>/AFILE as the work- 
file. The type is FORTRAN. 


‘ 
Slay. Wane - wy) Bild Mictaens Bly. nates Rete bi’ wail tO? eal Naa idigtel, ok LUNA LS eae, Bate Renee UG ol ee CRE dine) aso oak acaees T Daicie’ “ish anaes, tage Ulan dbgelra @ Gos. dae weve a? ht Saree eee ANN ed nd P ce re wed ee ame veel: ll atl ne te ite nll. 
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GET #AFILE 


This toads an existing file named AFILE from the system disk. 
The type is the file type as defined in the disk file header. 


GET USR/NEW UPL 


Get a copy of a file named NEW that belongs to usercode USR_= and 


load it as a UPL filee 


GET AFILE =: PATCH PATCHFILE | 

This opens the source file AFILEs then toads records from PATCHFELE 
into the workfitle as if they had been sent from the terminal. 

GET AFILE : PATCH 


AFILE is opened as the source file» and CANDE is signailed that edited 
records witli be SAVEd with the PATCH option. 


AeA tee Me ee ees « Cn i en en i ae aed 
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HELLOZUSER 


The HELLO/USER command initiates 232 new user session without 
explicitly terminating the current session. 


syntax: 
HELLO SDD RO SSO DOOD SHS BSBA TABDeVTs TB Cas eeaecanaaecaesaeves 5 § 
USER <-->] | i 
oa j ase ee ceewoece= <password> aae> | 
i | 
l-- / -->1 
semantics: 


The current user's session is terminated by implicitly performing 
the BYE command and then invoking the normal logon process to 
initiate the new user's sessione AS with the BYE commands this 
command is in error if the current userts workfile has not been 
Saved or removed. If the station is not currently lagged oanp 
then only the normat tog-on procedure is invoked. 


Usercode and password may be inctuded to coaplete the log~on 
procedure or this information will be requested in the normal 
tog-on manner. 
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INSERT 


The INSERT command copies records from the workfile» or from a 
file on disk» and places the copies tnto the workfile with new 
sequence nurmberse 


Syntax: 


INSERT 0 GO ES GE GP OD OD NE OS OE 8 OO O88 OO 8 O88 8 88 8888 OOOO OOOO O22 Oe 22 > > 


= i i i i} i 
j-- # ->1 |loo- <filename> -->1 I-- <seg range> ->i 


Semantics: 


INSERT copies records from any file to which the user has access 
or froa the workfile by defaults» and enters them in the workfile 
as a contiguous block. The entire file will be copied if a 
<filename> is specified and the sequence range List is omitted. 


New sequence numbers are determined by assigning an initial value 
to the first line and incrementing that value for each succeeding 


line. An integer <base> specifies the initial vatue. The 
increment <inc> for successive sequence numbers in the btack may 


be specified as an explicit integer. If none appears» the 
default value of 100 is used. 7 
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The range of new sequence numbers may not overlap any lines 
already in the file» nor may the numbers exceed the tlargest 
sequence number which may be expressed in the sequence number 
field. If the format #*<filename> or *(Cusercode)/file-id is used» 
CANDE wili look oniy on system disk for the file. 


Inserting into a fitle of type DATA is not allowed. Also» DATA 
files cannot be inserted into a workfitle. 

Examples: 
INSERT AT 30004100 


Insert the entire workfile into the workfile starting at 3000» in 
increments of 100. 


INSERT AFILE 1007600 AT 4000 


Insert the tines 100 through 500 from file AFILE into the work- 
files» starting at 4000 and incrementing using the default of 100. 
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LIS! | 


The LIST command displays the contents of the workfile ofr some 
other file to the user at his terminati. Options are avatlable 


for setecting specific lines and columns. 


Syntax; - 


LIST 2228 2 See Bese ee eee Beene eee Sete eaewo ase sees wsaseaaewaanewoaaae=) Z 
0 | ewe ewe cee eee eo 2 ee eee ee ee 222 eee 6 ee fee eee wea eneeee {| 

j-- fir anwWm ee eae a <filenanme> esennweaewoevaaeeaace2eoeee=)> |} 

i i-- # =>] I-- <type> -->1 | l 

! 1 

fe- s/iN > as a a an oe oe <sequence range> scan esawseaaenoneceoo= > | 

j ! 

je- JIN = a) em ob an =e a -—<- 2 €coluan range> eecewoeeees eeee=) ] 


Semantics: 


The contents of the workfile are listed by default. If a <file- 
name> is specified and if the user has access privileges» the 
fife is Listed. If *#"* precedes the filenames» the filename is 
taken “as is". A <«type> may be specified» so that sequence 
numbers can be located in relationship to the text. If no <type> 
is given» the type is as defined in the disk file header for the 
file. 


A sequence range and a column range may be specifieds otherwises 
the whole file and the entire iine are Listed. Specification of 
a single sequence number will display that sequenced record only» 
rather than a page beginning with that record. (Csee *PAGE™) 


Lines output to a terminal have the sequence number on the left 
end of the record. 
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MAKE 

The MAKE coamand creates a new workfiles If an unSAVEd workfile 


already exists» the MAKE coamand is in error.e 


Syntax: 


MAKE Swen aeane2aonoenaae <fileeid> Seems ewan wee tec wocnwwooeaseo== > Zs 
= j i 


Semantics: 


The <file.id> must define a new file within the user's library; 
it becomes the name associated with the workfile. A type SEQ 
file is assumed by default. Gnly a <fite.id> may be specified 
with the MAKE command. 

Exaaples: 
MAKE AFILE 
Make a new workfile with the name AFILE and a default type SEQ. 


M AFILE U 


Make a new workfile with the name AFILE and a type of UPL. 


“ 
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MARGIN 


The MARGIN command controts the entry of text at the left margin 
of a line by inserting a specified number of blanks in front of 
the data being entered. A margin specification may be in absoa- 
lute column nuabers or relative to the previous margins it may 
be effective for all subsequent lines entered at the terainats or 
for a single line. 


Syntax: 


MARGIN 2 00 08 2 88 808028 6 0 22288 288 22 eee ewe ew eens eons soeest eee > Z 


sae as { ] j 
{ | 1 
j@---2 + awe>| --- €coi> aa=e> | 


Semantics: 


If an unsigned integer <col> appears» the margin is set to that 
columns» relative to column one at the beginning of the tine. The 
value af <col> must fail within the text field of the line» 
Ceege»s should not exceed 72 for UPL files). 


If a signed integer <col> appears» the margin is moved left (=) 
or right (+) by the number of cotuans specified; the resulting 
value must fall within the text field of the line. 


MARGIN with no other parameters witt elicit the response: 
CURRENT MARGIN=<integer>. 
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The new Margin specification applies to ail subsequent entries 
fro@a the terminal» until anew margin specification is entered or 
a GET or MAKE is performed. 


MARGIN is anly applied on records entered singty» from the top 
line of the terminal screen. | 

Exanptles: 
MARGIN+#5 


Change the indentation position to the current starting position 
plus 5 columns and retain this indentation for alt following 
inpute 
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MERGE/RMERGE 


The MERGE and RMERGE commands cause a specified files or portions 
thereof» to be merged with the workfile»s with the resuit becoming 
the new workfile. The two cogaands differ in precedence consid- 
erations when a record in the merge file has the same sequence 
number as arecord in the workfile: MERGE keeps the workfitle 
record and discards the other> RMERGE does the reverse. 


syntax: 


MERGE ONO Oe 29282828822 <fiilenarge> see eeeee ene ce eeastaerwoaeasecoe=)5 Ff 


=== if i i | 
| | { 1 
RMERGE =>] I[-7 # 27>] l--- <sequence range> -~>! 


Semantics: 


The <filename> specifies any data file the user is ailowed to 


read and **”* indicates not to expand the <filename>. If a 
<sequence range> appears» onty the selected records are serged 
and the rest of the file is ignored. The sequence numbers of 


records in the merge file remain unchanged as they enter the 
workfile. If the workfile is of type data» these commands say 
not be used. 
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Exargoless 
MERGE SYMBOL 


This merges the workfile with the complete file SYMBOL» keeping 
the workfile copy of records with identical Ci.eee» duplicate) 
sequence nunabers. 


RM PATCHES 4S007END 


This merges the lines from 400 through the end of fite PATCHES 
with the workfiles» discarding the workfile copy of dupticate 
sequence nusbers. 


ne 
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MOVE 


The MOVE command soves Lines from one point to another within the 
workfiles, and changes their sequence numbers. 


Syntax 


Im" #<3nc> =>! 


Semantics: 


The lines in the sequence range are deleted after being entered 
in the workfile as a continuous bdDlock. 


New sequence numbders are determined by assigning an initiat value 
<base> to the first tine and incrementing that value for each 
succeeding line. | 


The tnerement <inc> for successive sequence numbers in the block 
may be specified as an eaxplicit peegetS- If none appear se a 
default vaiue of 100 is used. 


The range of new sequence numbers say not overtap any lines 
already in the file» nor may the number exceed the tLargest 
sequence number which may be expressed in the sequence number 
fieid. The destination may not overtap any existing records in 
the workfile. 


ee Be Je | 
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Exauples: 


MOVE 100-600 to 9005 


This removes Lines numbered 100 through 600 and reinserts them at 
900s 905» 910 ee @ 


MOVE 1000 to 6000. 


This removes tine 1000 and inserts it at 6000. 
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PAGE 


The PAGE command disptays full screens of information at the 
terminal for editing» and accepts fult screens of input from the 
terminal. Gperations wiitl continue until the command parameters 
have been satisfied or the user enters any command on the top 
line of the terminal. 


Syntax: 


i | t 
jeer= NEXT se cert een eee ec eeaet ea tee ewe we ce eeoeeenen 5 | 
I = J 
je2-o END Swwwewee eet een ene eee ewaw ee eee ee wean ean) | 
i oS | i 
| <0 20 0 08 2 282826 0 8 C8 eee 8 022 2 2 e228 22 e Deana | 
I | ' 
Pere~> /eli\ “- Cdetinm><text><delim> cerertrsere=—>] 
i ! | I 
j-<-= 71% ONLY swe won een wewe ween aweows ceanaen >» j 
( = i 
j--- J1iN LITERAL = ssa gama aoeoanawoeeweaewooewa > } 
= | 
jo-= JIN | <coluan range> wwoewsecevoeeswooeacwwe =)» | 
| i 
asweoew = iN <sequence range> Sanna seownaeeaweeweme) | 


<detin><text><delim> scan each record within the sequence range 
| for the delimited text. Display page 
Starting with the record in which text is 

found. 


<sequence range> assumes <first record>*<last record> as 
the default. If only the first record 15 
specified Ceegs» PAGE 2500)» the program 
assumes that the range requested is 
2500“END and displays whatever records are 
in the file at the sequence range 2500 and 
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higher» as many as are required to display 
a full screen. 


ONLY dispiay onty records with target texte 


LITERAL as in REPLACE» FIND. 

NEXT resume action requested by previous PAGE 
command. 

END displ ay the last page of the workfile. 


Example? assume page size = 2 and file contains: 


100 abcdef 
20G ghijkk 
300 tmnopg 
400 rstuvw 
500 xyzabcd 
600 efghijkk 
700 tLanopa 


Cosgsand Response 


PAGE ONLY /KK/ LITERAL Display records 200 and 600» then 
terstinatee 


PAGE 100 Display page beginning with record 100» 
then terminate. 


Note that for CRT devices» NEXT is written at the home position 
as in FILE POSITIONING. For text searching» NEXT means begin 
searching with the next record after the first displayed Cif ONLY 
is not specified) or last displayed Cif ONLY ts specified). 


Note that the meaning of a single sequence nusber in a sequence 
range specification is now different for LIST than it is for 
PAGE. , 


eee See een eit Oe uote Same OE der apitedl nein wa yee! Pardue Sarah ARR eRe tone MYTs INRA! Dey hy si UU ANB DME ERAS SOR OL « SE = 
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LIST <seq> wiit display the single record at 
sequence nuaber <seq>. 


PAGE <seq> will display a page of records» the 
first of which is the record at 
sequence number <seq>. 
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PASSWORD 


The PASSWORD command allows the user to change his password. 


Syntax: 


PASSWORD *" <current passwWord> “= <new password> ewer rre"">> 


Semantics: 


To change passwords» a user must enter his current password» the 
new passwords and for verification purposes» rapeat the new pass~ 
vord. 


Passwords must contain no imbedded blanks. Other than thise each 
password may consist of any character sequence except *"Ctwo 
doubie quotation marks)» which is taken to mean a Blank password. 


bem eee welpraate dy mere enn fodinlt See ee a et . ee ene, ert Se Ty 
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RECOVER 


The RECOVER command recails a recovery file as the workfile. 
After an abnormal termination of CANDE» those users who were 
logged on the system will have the option of recovering the work- 
file at that time. 


Syntax: 


RE COVE Ree 0 2 00 2 20 2 ee ee 20 2 2 282288 ee ne ce wee ee eae eee waw asa eanran> ff 


joerc 4 PURGE ase v2eceoece =)» } 


Semantics: 4 


By entering RECOVER after Logging on» the user can recover his 
workfile. The PURGE option allows the user to remove a recovery 
file which he does not want to recover. 


Examples: 


REC 


This recovers the user's previous workfile. 


RECOVER =P 


This removes’ the user’s recovery file without loading it as a 
workfile. 


ae catia, anal dite Sued os 
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REMOVE 


The REMOVE command may be used to remove the workfile or any file 
having the users usercode. 


Syntax: 


RE MOVE QO SASH STARS SVM OB Sean Daan caenewsananeneoasaaeneanecaanoecesaccecoean@) f 
-—- 2 i i 


{ 1 i i 
j le- ON <packerid> <-->] i 
i { 
j-- OBJECT sQe2 seen eas concn mena s ene aes eecaes ween oaesweee) j 
| ! 
j-- OBJECT assem uneanaaanva €<filename> sen enanmannwoeaeweanae) | 
: i | 

i I-- $ -=>1- 

1 l 


j«c3-- & sasseaamaoceoae) | 


Semantics: 
The semantics vary with the form of the command. 
REMOVE 
Removes the workfile. No further editing can be performed until 


a GET or MAKE 1s performed. 


REMOVE <file-name> 


Removes the user's source file <usercode>/<file-id>. 
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REMOVE OBJECT 


Removes the user’s object file <usercode>/<workfile name> CAT 


“0? . 


REMOVE OBJECT <file~name> 


Removes the user*s object file <usercode>/<file-name> CAT “0". 


REMOVE OBJECT $<file-nane> 


Removes the user*s object file <usercode>/<file-name>. 
REMOVE <fitename>. 


Removes the file <filename>. 


Examples: 


REM 


This removes the workfile. 


REMOVE AFILE ON <packrid> 


This removes <usercode>/AFILE from pack <pack~-id>. 


REMOVE OBJECT AFILE 


This removes <usercode>/AFILEO if the file is of type "CODE". 


REMOVE OBJECT SAFILE 


This removes <usercode>/AFILE if the file is of type "CODE*™. 


REMOVE DSOONER/DFASTER ON DPACK 


This removes DSOONER/DFASTER from pack DPACK. 
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REPLACE 


The REPLACE command scans lLinesbysline through the workfile or 
selected portions» replacing certain target text with new text. 
REPLACE is also a prompt driven command» output comes to the 
terminal after transmission of any character from the home posi- 
tione A “?BRK" wilt break the output as soon as possible. 


Syntax: 


REPLACE -aeewecncnnnnnnnnnnn= <del im><text><delim> s-------=>> 

; ada <count> a i eee <col i> ieacnachenaeaicnioaane 
tis FIRST a | | - -<col 2> a 
apes LITERAL hes 


| | 
[|< wees wee ee ees coc ee ee eoesasesoae | 
{ . i 
I-/i\ -- <sequence range> *7-r7>! 
| { 
I“/1\ 77 2 <column range> °*7-77-7>!1 


i : i 
| Koen renner ennnne--=] 
1 i 
Pm“s2N 22 8 m1eZ2N = TCEXT) son--! 

! 1 


I“/1\ = TRCUNCATE) <1 
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Semantics: 


Only one replacement may be specified in each REPLACES the 
replacement is defined by a target and a substitution. The 
target specification may contain a text fieid or column nuabers-, 
the substitution specification always contains a newtext field» 
which can be blanks. The <text> and <newtext> fietds are brack- 
eted by delimiters. The <text> or <newtext> may contain any 
characters except the delimiter. : 


Using COLUMN <col 1> causes the <newtext> to be inserted at the 
column specified. Using COLUMN <col 1>-<col 2> means the charac- 
ters in columns <col 1> through <col 2> are to be reptaced by 
<newtext>. 


For purposes of the search» all strings are considered to be 
token strings. Fach tine of the file is considered as an arbi-~ 
trary string of tokens» excluding blanks. The search is 
successful whenever the string of characters in the text field is 
found in a tine of the file. Literal strings must be searched 
for in LITERAL mode. 


if the keyword FIRST appears» onty the first appearance of the 
text on any line ts sought and reptaced. If an integer <count> 
appears» the replacement wiid be terminated after the program has 
replaced <text> with <newtext> the specified <ccount> of times. 


The replacement may be restricted to a sequence range of the file 
or to a column range of the record. The defaults are the entire 
record length and the entire file. 


if the option TEXT is specified» the entire record ts output to 
the user's terminal. Otherwise only the sequence numbers of 
records affected by REPLACE are written to the terminal. 


fae aan anti bane id ean Le a ati ales 
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Whenever a target is founds the <newtext> Cwhich may be btanks) 
is substituted. Adjustment for different tength <text> and 
<newtext> is made by shifting the rightsthand end of the tine (Cor 
column range) to the left or rights» deleting or adding terminal 
blanks. A Line overflow 1s detected whenever the adjustment 
would shift non blank characters off the end of the Line Cor 
column rangede If the TRUNCATE option is specified» the REPLACE 
will be done even if an overflow occurs Cand text is truncated). 
Otherwise» the REPLACE ts not done. In any case» a message is 
given to the user concerning the overflow. 


For COBOL and COBOL74 fiies» CANDE does not allow mixing between 
the text (cot 7-72) and the identification (cot 73°80) fields. 
This means that if a REPLACE ts being done within columns 7-72> 
an overfiow is flagged if this REPLACE would move into column 73 
or further. It also means that you may REPLACE within columns 
7772 or columns 73780» but never a mixture of the two rangese 


Examples: 


REP *AB™*ABB" 


This searches the entire workfile for the string "AB" and 
replaces 1t with *ABB". 


REPLACE COL 1°5 / / 13507180 


This reptaces the contents of columns 1 through 5 tin lines 130 
through 180 with empty newtext. | 


ee — Sn NE ee NT ge ge ee a a Oa a RTT 


S744 


BURROUGHS CORPORATION COMPANY CONFIDENTIAL 

COMPUTER SYSTEMS GROUP | | B1000 CANDE 

SANTA BARBARA PLANT | P.Se 2212 5561 CH) 
RESES 


The RESEQ command assigns new sequence numbers to lines in the 
workfiile»s without changing the order in which the lines appear. 
The default vaiue for RESEQ is a base of 100 and an increment of 
100 for alt records in the workfile. 


Syntax: 


RESEQ <e8e eee cee seam enestaeseseseaaaeeesse= anenesssenasnameena==>} 
--- i i 1 i 

t f<" <base> sat ccee scream eenwee>| 

I-~ OVERRIDE -=->! f-- +#<inc> -7>] 

{ -— 2 a ap 

i 

Im <sl> e232 <<52> s2e= Chaser Teor wr ewer ene cenese=5§ 

I-- END -->! | [-- #<inc> -->! 


Semantics: 


The base value is assigned as the sequence number of the first 
line to be renumbereds each subsequent ltine*s number is equat to 
its predecessor*s number plus the increment vaiue. 


The vartable OVERRIDE informs CANDE to disregard any sequence 
errors Ce.ge» arecord with a blank sequencernunber field) that 
it finds in the workfile and merely resequence ite. If OVERRIDE 
is not set and CANDE discovers a sequence error in the original 
workfile>s it will discontinue its resequencing operation at the 
point at which it finds the error and inform the user that it 
cannot continue processing the file. When CANDE fails during a 
resequencing operations tne OVER option should be used to 
recover,s otherwises it should not be used. 


For example» if CANDE discovers a sequence error while tt 1s 


red 
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loading a file» RESEQ Cwith appropriate base and increment 
option) is ait that the program requires tn order to resequence 
the file property. 3 


If a range of sequence numbers 1s provided (si through s2)» only 
the specified part of the workfile is renumbered; by default» 
the entire workfile is renumbered. When this range is provided» 
an initial value must be specified as the <base>. The increment 
(<inc>) for successive new sequence numbers may be specifted but» 
if none appearss the default value of 100 is assumed. 


When resequencing Basic files» sequence numbers in the text are 


modified to match the new sequence numbers on the appropriate 


 recordse 


RESEQ will not change the apparent order of the lines. Si must 
be fess than or equat to <base> and the <base> plus the number of 
lines times the <inc> must not exceed s2 + <inc>. 


Examples: 


-RESEQ 200 


This renumbers the entire workfile» starting with an initial 
record number of 200 and proceeding in increments of i100. 


RESEQ 100-700 10010 


This resequences tines 100 through 700» starting with an initial 


record number of 100 and incrementing by 10. 


RESEQ +20 


This resequences the entire workfiles» with a base of 100 and 
incrementing by 20. 


ee — raere—saaryers 
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RESEQ 1000-1500 1100410 


This resequences records 1000 through 1500» starting with an 
initiai record number of 1100 and incrementing by 10. 


RESEQ 2700-3000 2000 


This is invalids ‘because the new base fails outside the 
sequencing range. 


ee ees ae ‘owe fer ag tte, ead 
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SAVE 


The SAVE command causes the current workfile to be saved. 


Syntax: Format 1 


SA VE OOO 88 O88 88S 28S S 22H 28D T8888 OO BBB BB HBO BeBe 2 Bee 22 »)>> 
be- AS seesceeresrr= <filename> -->! 
i i 


j-<- & a= | 


13 
i-- ON <pack-id> --->1 l-- tRESEQ -e-seeereen--=-=>1 


i-- <params> <-->] 


Syntax: Format 2 


SAVE -"" AS woteee= <filename> sorte sero ee seen cenea--)  SPATCH --># 


o> j | { j > 
[= 2] | | I-- ON <packwid> ==>] 


Semantics: 


If no <filename> is specified» the workfile is saved under its 
workfiile name. The workfile may be saved under a different name 
by using the "AS <filename>” option regardless of whether a_ file 
currently exists with that <filename>. Specifying “#"” will cause 
the fite to be saved with the actual name of <filename>. 


The :PATCH option allows the user to create a “patch™ fiite 
consisting of anly those records from a source file which were 
changed during an editing session. Deleted records are saved in 
a patch file as “SVCID*" records. If this option is invoked» the 
user must also specify the "AS <filename>" option. 


ax oy . : MS eee : * eesti igh io ie : Sovs, 2 sere. east eg ease! Era Se cee Ani cae oneal tee Ce Me Fl eb ee a eee % 


3748 


BURROUGHS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP B1000 CANDE 
SANTA BARBARA PLANT | P.Se 2212 5561 CH) 


To insure that the :PATCH option will yteld the desired result» 
editing of the workfile should be preceded by setting the user's 
patchrid field. see the PATCH MODE section for a more complete 
discussione | 


When SAVE with no options is entered» a SAVE .w«ee s2PATCH will be 
performed as a default 1f both the foilowing conditions are in 
effect: 


1) the user*s patcheid field is sets ang 
2) CANOE is aware of a fite name used previousty in editing 
this file» indicated either by a GET ae. sPATCH <patch=- 
fale-name> used to begin the sessione or by a SAVE AS 


<patch-filernaae> <sPATCH having been done during the 
current editing session. 


The :RESE@ option resequences ait or part of the new file. 
Parameters may be specified as in the RESEQ commands except § (“for 
the OVERRIDE parameter. This option is not allowed with work=- 
files of type DATA and BASIC» and cannot be used along with the 
sPATCH option. 


Exaaple: 


SAVE 


This saves the workfile. 


SAVE AS AFILE 

This saves the workfile under the name <default 
pack>/<usercoda>/AFILE. 

SAVE AS PATCHFILE <:PATCH 


Onty added» changed or deleted records (the tatter in the foram of 
$VOIO records) are SAVEd as <default pack>/<usercode>/PATCHFILE. 
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SAVE sRESEQ 2007500 2104190 
This saves the workfile>» resequencing records with present 


sequence numbers between 200 and 500 inclusive» giving them new 


nurabers beginning at 219 and incrementing by 10- 


SA AS FEE/FEE ON LARUE 

This saves the workfile under the name LARUE/FEE/FEEw. #£This may 
only be done by privileged users. 

SAVE AS #X 


This saves the workfile under the name X on system diske Thise 
too» may onty be done by priviteged users. 


Sr ra 
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269 
The SEQ command invokes automatic sequence modes causing the 
system to provide the sequence number for each new Line. An 
initial value is assigned as the sequence number of the next line 
to be entered, the value is incremented for each subsequent 
line. 
Syntax: 


SE Qe reer ecwoeeew wees ees eaewoe cect eee eoeezece wena see eee aw saw ews wee eoe= > Z 


- i | { 1 
j ~w#ececwoce <base> eenweee=)>» |] J <7 ceeee +<inc> ssan snes» ] 
i i 


J eww eee eee NEXT an awecese=) | 


Jenecenen= END -eenrne-->] 


NEXT Begin sequence numbers with last output # INC from 
previous SEQ. 


END Begin sequence numbers with that of the tast record 
currently in the file. | 


Semantics: 


The initiadi vaiue ts specified by an integer <base> or defauits 
to 100. The increment is specified by an integer <inc> or 
defauits to i100. If NEXT is specified» the sequence numbering 
begins with the tast sequence nuabdber displayed for that user. 
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Sequence mode is terminated either by entering the EOT character 
immediately following the sequence number or by transmitting back 
only the sequence number. CANDE then displays a message at the 
terminal that the automatic sequence mode is terminated. BACK» 
SAME» NEXT» -» and + will also terminate the sequence mode and 
then display the requested page. 


SEQ witd disptay existing records in sequence with the new 
sequence nusbers that have been createde Display will begin with 
the last record from the previous input if pagesize is greater 
than one. 


SEQ allows records to be added to the file. The command does not 
support MARGIN since a full screen may be transmitted and MARGIN 
only applies to single records entered on the top tine of the 
screene 


Examples 
S$ 120410 


This begins automatic sequence mode» using an initiat vaiue of 


120 and an increment value of 10. 
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QINGLESLINE ENTRY 


Any line beginning with a digit whose size is at teast the 
sequence field tength for the current file type is a “command” 
either to enter a new line of text at the sequence number speci- 
fied» or to replace or delete the tine already at the sequence 
nuaber . 


syntaxs 


1 j 


Semantics: 


The Line consists of an integer <sequence number>» <s>»s foilowed 
immediately by an optional <newtext> fieid supplying the contents 
of the new line. The sequence number begins tn the first column 
of the input tine and runs until a nonwdigit character is encoun 
tered or until the maximum number of digits for a sequence number 


have been entered; <newtext> begins in the column immediately 
following. If there is already a line of text at the specified 
sequence number » that line is reptaced by the <newtext> or 
blanks. 


Examples: 


100 THIS IS A NEW LINE 
215 AND SO 15 THIS 
300 


This causes record 300 to be bianked out but not deleted» in 
addition to creating or replacing Lines 100 and 215. 
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. SPATCH 


The SPATCH command aitows the user to insert up to 10 characters 
of patch identification information into columns 81°99 of the 
workfile records for att file types except “DATA"™. The command 
remains in effect until the user requests that the workfite be 
saved as a permanent file. Setting this command also flags CANDE 
to disallow any command Cexcept REMOVE) which wilt flush records 
from the master workfite Csee PATCH MODE section for complete 
explanation). For exaaple» when SP is set» users must etther 
save their workfiles as patch files or clear the patch designa~ 
tion before attempting a SAVE. 


syntax: 


l-- <sequence range> “<->! 


Semantics: 


A delimited text string of up to 10 characters is required with 
the SPATCH command. If the sequence range 1s omitteds then the 
delimited string is saved as a permanent patch identification 
string and is applied to future entries to the workfile. CANDE 
returns the message: 


PATCH ID CHANGED FROM *<old-patch-id>* TO *<new-patch~id>’. 


If the sequence range is included» then the patch identification 
string is treated as temporary and is immediately inserted into 
the workfile records specified by the sequence range. This 
latter form of the SPATCH command does not change any paeryeus 
permanent setting of the patch tdentification. 


coe a Se ee ee ee er cs 
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Any existing patch tdentification string may be cleared by 
entering a null patch identification. 


Examples: 


SP /ABC/ 1O00-END Piaces string “ABC™ in records 100 to the 


end of the file. 


SP /XYZ100/ Sets patch identification string to 


included on all new records from this pointe 


SP // | Clears patch identification string. 


BURROUGHS CORPORATIO 
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ss 


The SS cosmand prov 
Station or to the OD 


syntax: 


235 ase Gua cana aaanaae 
<2 ms a a oD a oe a ee 


Jf ewe eceeeeceoeceo= 


} wep © a eh Ee ae 8 SS = = 


Semantics: 


The receiving statio 
code> of aeeuser 

consist of any chara 
the sending or recei 
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tides the ability to send a message to another 
T. 


} 
i 
<usercode> w7277°7">>] 
i 


n may be referenced by <ilsn> or by the <user- 
who is logged on the system. The <text> may 
cter string up to the maximum tine size of 
ving terminal. 
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TEACH 


The TEACH command provides the user with the capability of 
requesting an explanation of CANDE commands. 


syntax: 


TEACH ene see we meen eee ee weet e ee case wa es emo es ee eee cee eeoneewestacecenz=)> 


Semantics: 


Entering TEACHs without any specific command specified» causes 


the system to return a complete List of valid CANDE commands and. 


their valid abbreviations in the form: 


<abbreviatian> (<remaining letters>) 


for instances SPATCH will appear as SPCATCH). 


Entering TEACH <command> wilt cause the system to return three or 
more lines of text with a full description of the semantics and 
syntax of the requested command. Entering TEACH BYE» for exan- 
ples returns: 


COMMAND: = BYE 


SEMANTICS: TERMINATES THE USER*S CURRENT SESSION 


SYNTAX: BYExaeeexaee>d|] 
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TERMINAL 


The TERMINAL command witt allow the user to specify or query the 
number of lines per page or per screen for his terminals or to 
modify the output mode of the terminal. 


Syntax: 


>em= TERMINAL totter s scene ener ncn nn cnn cnn nn ce cence ence nnn enn-=># 


| <--- ons PAGE ono n nnn rn ener nn nnn ne ne nen en n---->} 


-2-{ i I-- <page Length> ~"°"-=>>! 
I | | i 
po CONTINUGUS 22eS23 S32 8243564 eeSs=ss55<"2> | 


Pane WAL Tenn n nnn nn nnn nn nn nn enn nnn nn ===>] 


Semantics: 


PAGE specifies the number of Lines per page or per screen» as an 
integer <page-length> between 1 and 22» inclusive. 


fat 
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Default page sizes are: 


Device Terminat Type Page Size 
89350 Teletype. 0 i 
TC Series Cle 232 Zhe 259 26m 27 | 
TO700 | 32 2 
TD730 33 2 
T0801 41 10 
T0802 42 22 
TD822 : 43 10 
TD8&22 3 44 22 
TO083l 45 io 
TO832 46 | 22 


Default page sizes are also maxinum possible vatues. 


If no parameters are specified» then the current page size and 
current output mode are displayed. If PAGE is specified without 
the <page tength>» then the current page size is displayed. 


CONTINUGUS causes the terminal to be left in ‘freceitve*® mode 
unconditionaily after each output Cif scrotling is enabled). 


WAIT» the default output mode» causes the terminal to go to tocal 
mode after most outputse 


10730 terminals are treated as TD700s. T0830s are treated as 
TD820s except for the fastselect and stop highlight characters. 
TO830s running on twortwire direct connections should have their 
system adapters strapped for a 15ms write-deiay. 
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TITLE 


The TITLE command changes the name of the workfile or a file on 
disk. 


Syntax: Format 1 CWorkfitle Onty) 


TITLE sone nen nnn enna nnnnnnnnnn-- <filesid> cece c steers s22e=-->2 


a= i i 
j«7<-< TOG oaww> | 


Syntax: Format 2 (CExternai Fites) 


TI%TcLeE _- 2 2 = = <filename i> <0 ad GP aD OD ee oD wD oe oe ee ae <filenagme 2> aowaaane > 
a= 1 . i i l 
j pee= TQ =>! i 
i i 
f-- * <filename 1> 2-7 TO ="" * <filename 2> -s3eeee""=>/i 
! i 
f-- QBJECT eeereerrer-> <file TO OBJECT ereerrn" <file <->] 
{ <= i i namel> ae i | name2> 
| I- $ =>] im $ =>] 


Semantics: 


The name of the workfile (Format 1) is changed for any subsequent 
SAVE commande. 


The name of <filename 1> is changed to <filename 2> (Format 2)» 
which must be a new filename within the user's Library. 


eee aes kd, een ees Re A ei + ERT Ady rete ee ie ve Sw eae i oe oe + 
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Exampies: 


TI ZAP 


This changes the name of the workfiite to ZAP. 


TITLE A TO 8B 


This renames the file named A as Be 
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WHAT 


The WHAT command indicates the state of the workfile. 


syntax: 


WHAT Se 2G e822 Se Bee 22S OSes cas ees een e acess wes eee swe saen» ff 


Semantics: 


The amount of itnformation provided varies depending on the 


current state of the workfiles as much information as is avail~ 
able is indicated. Output may include: 


USER: <usercode><(PRIVILEGED) If priviteged 
user>. WORKFILEs <filename><filetype>>» 
<saved status>» <tnteger> ENTRIES. 

SOURCE FILE: <filename> ON <pack.id>» <integer> RECORDS. 

PATCH ID: <character string>.j DEFAULT SAVE 
PATCH“FILENAMEs <filename>. 

DISK REQUIRED FOR SAVE: <integer> AREAS» <integer> 

SECTORS EACH. 


The “source fite size*™ is the number of records present when the 
tast GET or SAVE was completed. 


The "number of workfile table entries” is the number of news 


changed or deleted records (Cexcept that a deteted range of 
records wiil appear as two entries). This number wiii be zero 
immediately after a GET» SAVE» or RESEQ and sometimes after 
INSERT Cfrom an external file)» MERGE» or RMERGE.- PATCH FIELD 
inforgation does not appear if a patch fietd (SP) has not been 
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specified. 


The “disk requirements” information is intended for user estima~ 
tion of the amount of disk space he wilt need to have avaitable 
when he enters SAVE. Currently» CANDE cannot recover from a “NO 
DISK SPACE" error on attempting to open a new areae Therefores a 
user might initiate a SAVE which uses up all available space on 
the specified disk before completing» thus causing CANDE to 
“hang"» waiting for the operator to clear the disk and then *OK"™ 


CANDE. If» under extreme situations» ali disk space is dedicated 


to this file and thus disk cannot be cleared» the only way to 
resolve the situation is for the operator to "DS" CANDE. 


foal 
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WHERE 


The WHERE command provides the <tsn> of a user. 


Syntax: 


Semantics: 


If the specified usercode is currently logged one then his <isn> 
is provideds> otherwises the user is so notified. The ALL option 
gives the <lsn>s of all users currently togged onto CANDE. 
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WRITE 
The WRITE command outputs the contents of the workfile or a spec- 
ified file. In either case» the output does not go directly to 
the device. It is forced to backup» identified as print oor 
punchp depending on the user option specified in the WRITE 


syntaxe Options are availabie for selecting specific tines or 
coiunrnse 


Syntax: 


WRITE e888 62924 e4 8368 e8 95354 928298855685 536222 aaa a eae a a'> f 
-- |< emeemenenn we wenn cn ee nee owen ns eee e nen e nnn s--=] 
fersi\errre<s" <filename> were csecsesecesesece=) j 
j im #2 =] i-- <type> -->] i 
i i 
bes i\ersser= AD Sse aeere= <tilenaske> Sere e="> 1 
I | " 
l--/1N\e7---- <sequence range> **2eseteteer%r""">1 
be"/iNeoseH= <coluan range> sett tees eererreee=>] 
feems/iNewrrnw= sCOPIES <integer 1 to 63> 22777 >] 
[ees 1) \Ssess=. 10 S22" PRINIER S223 246 Seeseseeee> | 
Il-- CARDS =->1 : 
i= PRI Sees] 
i=" CRD e354 


Semantics: 


By default» the contents of the workfiie are written. Ifa 
<filename> is specified» and the user has access privileges» or 
1f the file ts publics» it is used. 


If AS <fitlename> is specified» this filename will be used for 


constructing the backup filename. 


A sequence range and a column range may be specifieds otherwise» 
the whole file and the entire tine are printed or punched. At 
the terminal» the user sees how many records were printed or 
punched. : 
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The ‘"**" indicates the file should be created with the name that 
was specified and should not be expanded. 


The COPIES option wilt be honored by SYSTEM/BACKUP unless over- 
ridden by the operator. 


This command should be used in conjunction with the autoprint 
routine in the MCP. If the autoprint option is set» WRITE gener- 
ates a backup file that wilt be printed or punched when the 
autoprint routine gets to the backup file. | | 


Note that CANDE never writes directly to the Line printer or card 
punches Since a “not ready™ condition on one of these devices 
would cause all CANDE processing to watt. 

Exampies: 
WRITE Writes att records in the user's 


current workfile. File is a backup 
print fife. 


WRITE 10071000 TG PRINTER Writes records 100 through 1000 inclu- 


Sivee 
WRITE *CUC)/A Writes all records in file CUC)J/A. 
WRITE A AS B Writes all records in the file (UC)/A. 
The backup print file created is named 
CUC)/PRITB. | - 
WRITE A TQ CARDS Writes alt records in the file CUC)/A. 
| The backup punch fite ts naned 
CUC)/PCHA. 
No te: The autobackup printing facility cannot be used by 


CANDE if CANDE ts not executed with file security. 
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2<MCP control string> 


A question mark in column ones Line one of input followed by any 
string whose first token ts not a vatid CANDE controt command 
will be sent to the MCP. If CANDE is running with file security» 
the first 250 characters of the MCP response witi return to the 
terminal of the initiating user. Otherwise» the user will ontly 
be notified whether or not the Zipped string was accepted by the 
NCP. | 


” AE ME RT lt ATE ten, oe > 
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QPERATOR INSTRUCTIONS 


This section is intended to provide the host system operator for 
CANDE with facts to hetp execute and maintain the CANDE system. 


Topics discussed here are the execution of CANDE» the use of the 
network controtler» and options available to the operator for the 
maintenance of the CANDE systeane 


The operator should have avaitabie for his use copies of these 
docusgents: : 


Burroughs 81000 Message Controt System [Information Manual 
Burroughs 81000 Network Definition Language Manual 
Burroughs B1000 Software Operationat Guide 

Burroughs 81000 CANDE Information Manual 


EXECUTION OF CANDE 


To use the CANDE system» the operator executes CANDE.] CANDE will 
in turn execute the network controlier if possibile (Csee below). 
Both CANDE and the network controller shouid execute at a higher 
priority than other oprocrams in the mix to insure adequate 
response times to the user. If an MCS is to be included in the 
mix» it should be at a higher priority than CANDE» but not higher 
than the network controller. 


Upon execution CANDE will determine if recovery is appropriate,r 
and if so wilt build individuat user recovery fites for the 
previous CANDE sesstone CANDE wilt then condition its working 
files for the new session. 


Finaily» CANDE witt execute the network controtter if the 
following conditions are trues: 


The network controiter must be presents a valid code file» 
not currently executings and named “"CANDE/HANDLER™ etther 
on system disk or on the same user disk from which CANDE 
was executed. 


~ 


ne 
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Program SWitch O» in CANDE» must be set (€i-ee» greater than 
zero). | 


If the network controtler cannot be found ofr was not executed due 
to any reason other than SW 0 equal to zeroe the cperator wiit be 
notified via the ODT. <Any desired network controtler can then be 
executed. Note that by resetting CANDE*%s program SWitch OO to 
zero» a file named “CANDE/HANOLER™ can reside on disk and CANDE 
wili not attempt to ZIP“execute it. 


Note: If a handter exists in the name table and CANDE ZIP- 
executes a handler» a DS situation could occur because of 
more than one handier being executed. 


PROGRAM SWITCH SETTINGS 


The following program switches may affect CANDE*s run processes: 


SWO if not Zeros CANDE wiil attempt to ZiP-execute 
CANDE/S HANDLER. 


SHW1i aif not zero» CANDE will be “frozen” in memorys and not 
eligible to be rolied out. 


SW2 if equat to 1» CANDE wittl produce certain statistics 
regarding this run at EQJ (Conty functional when the 
program is compiled with the conditionat option STYATIS=- 
TICS set). 


SW3 if equat to i» CANDE wifi read from and write to special 
queues instead of its remote file (Cfor debug purposes 
when the condittonat option SIMULATE is set). 


SW4 if not zeros CANDE will wait on an ACCEPT at BOJ Cfor 
debug). 


SWS if not zeros» CANDE will enforce file security. 
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FILENAMES 


User files in CANDE may appear to the user to have but one file- 
name of up to ten characters in length. This is purposely done 
so that a user can create and access files without knowing or 
specifying the file's fuil name. 


There is» however» the capability Cin Mark tevel IX.0 and iater 
versions of CANDE) of explicitiy specifying a full filename. 
CANDE informs the user if any security violations occur. 


BOT Options 


CANDE altiows communication between terminats themselves and 
between terminals and the system GODT Cor vice versa). Messages 
coming from the terminal will appear as: 


USER = <isn>2<textual message> 


The operator can taik to the terminai by entering: 


<CANDE mixtindex> AX <usercode> <message> 
or 
<isn of destination terminal> <message> 


EXAMPLES 


LAX JOHN WHAT FILE ARE YOU USING? 
QPERATOR COMMANDS 


The system operator has certain commands that can be directed to 
CANDE.}j These commands are WHO» STOP» ALL and MAKE.} WHO prints a 
list of usercodes and associated togical station numbers that are 
currently logged onto the system. STOP brings CANDE to a Logical 
conclusions this command wilt only be executed if there are no 
users togged onto the system. The ALL command ailows the oper- 
ator to broadcast a *message to ail terminaits.= MAKE Lets the 
operator make a station READY. or NOT READY. 
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MAKE 
Syntax: 
MAKE S34" <LSA>: S2e2ee"ss eee" 5" “= READY -~># 


j-- NOT -~>1 


The READY flag tn the network controiierts tabie for the speci- 
fied <tsn> will be changed as requested. 


Whenever a station*’s READY fiag is changed» the network 
controller will rebuild the autopoilt List to delete any stations 
made NOT READY and include any made READY. | 


AUDIT 


CANDE audits its own I/0s whenever it is executed with enough 
dynamic memory to handte its auditing functions. The AUDIT 
command allows the auditing capabiiities to be set or reset 
Without rewexecuting the program (when dynamic memory has been 
provided). 


Dynamic memory for the audit file is provided by executing CANDE 
with a dynamic memory of 5760 bits CEX CANDE ME 5760). If the 
program is not executed in this fashion and auditing is reques= 
ted» it wilt be denied (NO DYNAMIC MEMORY FOR AUDITING) and CANDE 


Must be resexecuted with sufficient dynamic memory» i.e.» a. 
ginioum of 5760 bits. 


Whenever an audit file is closed. through the CLOSE option»s the 
user should immediately print it with CANDE/ANALYZER» remove it 
from the disk directory», oor change its name so that the next 
CANDE/AUDIT fiie opened does not. cause a “dupiicate-fiie®* error 
condition. Since initialization of the audit file is aetime- 
consuming process» the user should be aware that an AUDIT CLOSE 
followed by an AUDIT ON witl cause a temporary suspension of 


datacoma service by CANDE white the audit file is being re~ini- 


tialized. 


Rd 
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The syntax for AUDIT is defined as: 


boo ON wee eer enc neesenn--=>1 

Joo OFF cece n nen neene---->1 

| anc ennneeen--"- CLOSE <->! 
I-- OFF -->1 


Semantics: 


AUDIT Displays the current status of AUDIT: whether 
it is ON or OFF and whether or not the AUDIT 
file is open or ctlosede 


AUDIT ON Sets the AUDITING option ON and opens and 
initializes the audit file if it was closed. 


AUDIT OFF Resets the AUDIT boolean but lteaves the AUDIT 
disk file pointer intact and ieaves the AUDIT 
file open s0 that the next AUDIT ON command 
begins auditing where the last auditing left 
off. 


AUDIT LOFF1 CLOSE Resets the AUDIT option and toses the audit 
file on disk. The next AUDIT ON causes a new 
audit file of the same name CCANDE/AUDIT) to 
be vreated and initialized. The dupiicate- 
file restrictions mentioned above apply to 
this command. Note that CLOSE 1s sufficient 
to close the audit file and reset the audit 
option to OFF» but that OFF CLOSE» although 
redundant» is not prohibited syntax. 


CANDE writes an “*audit~on™ and “auditroff* record into the audit 
file whenever the audit bootean is set or reset so that those who 
examine the file witt know the period of time during which 
auditing was not donee 


6-6 


BURRGUGHS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP BL0O00 CANDE 
SANTA BARBARA PLANT PeSe 2212 5561 CH) 
— stae 
Syntax: 


STOP nse canvan awa nawaaaaaoaaanwan > 


i-- <n minutes> -->1] 


Semantics: 
<CANDE*S mix> AX STOP <n> 


The STOP command» for automatic shutdowns provides for controlled 
Shutdown of the CANDE system within <n> minutes» with <n> being 
optionats» anda defauit of 2. When entered at the ODT» the 
command causes the fotlowing: 


If no users are lagged ons CANDE goes to EQJ. 
Each Logged on user is sent the following message: 


CANDE WILL STOP IN <n> MINUTES. PLEASE SAVE OR 
REMOVE ANY ACTIVE FILE AND LOG OFF. 


At the same time each togged-on isn is reported at the OOF Cas 
before). After ait tlogged-on isns are reported» the following 
message is displayed at the ODT: 


CANDE WILL ADVISE AUTOMATICALLY AT <hhimmiss.t> 
IF USERS ARE STILL ACTIVE> 


From this point ons the only commands allowed are: 
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Controt cosmands ("7") 

RECOVER UPDATE BYE 

REMOVE WHAT DCSTATUS 

SAVE RESEQ FILES 

TEACH 


Gne more page of input records will be processed» so any page in 
the process of being edited when the STOP occurs witit not be 
lost. 


Note: No further ‘singlectine® input is ailowed»s except when 
that line comes from a device with a pagesize of Ll» in which case 
it is treated as *one more page of input records® as above. 


Atl other commands wiit receive the following response: 


CANDE TERMINATION IN PROCESS. PLEASE SAVE GR 
REMOVE ANY ACTIVE FILE AND LOG OFF. 


If <n> minutes elapse and there are still users logged ons the 
fotlowing message is displayed at the ODT: 


SHUT DOWN TIME HAS ELAPSED WITH USERS STILL ACTIVE. 
OPERATOR ACTION REQUIRED. 


None of the above conditions change except that CANDE will not 
advise the operator againe 


The automatic shutdown function is intended for the system oper- 


ator's conveniences not a user tnconveniencee To that ends CANDE 


witi never shut itseif down while users are active. It 1s the 
responsibility of the user» howevers to tog off when no activity 


a8 anticipated for a while. 


ve tenant at Ba one eel heel gee etcetera all 
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CANDEZHANOLER 

BASIC 


The interactive BASIC implemented for 81000 CANDE is tike that on 
the 86700 CANDE.j The user creates his fite» then enters COMPILE> 
RUN» or EXECUTE» and CANDE handles aii file equations for the 
taske To make use of interactive BASIC» a naming convention must 
be followed in the NDL handler that is generated» the filename 
for the station must be “"F" CAT <station name> and this name must 
not exceed four characters on COMPILEs» RUNS» and EXECUTEs of 
BASIC files. 


SCROLLING 


TD820/830 series devices are capable of scrotting. Scrotting is 
enabled by entering a "?+S" and disabied by %2?-S". In SCROLL 
mode» all entries are made on the top line» but the entries are 
roiled to the bottom of the screen and the responses come back 
from the bottom up. =2#95" entered on devices that do not scroil 
will generate the response “‘*NOT A SCROLLING ODEVICE™. To 
correctly determine the type of terminal» users must observe the 
foliowing conventions when compiling a network controtter to run 
with CANDE: | 


sd 


nd 
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NDL ®*TERMINAL TYPE® 


NUMBER TERMINAL NUMBER TERMINAL 
0 89350 CTELETYPE DEVICE) 32 T0700 
1 B9353 (BIDS) 33 10730 
2 B9352 WIDE CCONRAC) 34 = 
3 89352 NARROW CCONRAC) 35 = 
& = 36 - 

5 = | 37 - 

6 RT2000 38 = 

7 TT102 | 39 - 

8 TT602 40 = 

9 = 3 41 ToSsol 
10 REDACTOR I 42 TD802 
il REDACTOR II 43 TO821 
12 = 4h TD822 
13 DC110 45 T0831 
14 DC140 46 TD832 
15 TU300 47 > 
16 TU400 | 48 = 
17 TU500 49 = 
18 = . 30 = 
19 TU700 sil = 
20 TU80D 32 = 
21 T0500 53 : 
22 = 54 = 
23 TC700 55 a 
24 TC1700 56 = 
25 103500 37 = 
26 TC4000 38 bee 
27 ~TC5100 39 = 
28 = 60 = 
29 _ 61 = 
30 = 62 B1700 
31 = | 63 B6700 


MeN 8 a mea eR een See ected Magellan pam alist AE ee eee a PCs gat adh we eed we ee ie at a pid “Apeme eS ag Hee? pn me emma A Te et eg rt Oe nm ee Leet cee au ee at rem nama anata a aa” cael ata aca ume at TS 
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TERNINAL SECTION 


See the TERMINAL command CCOMMANDS Section) for valid terminal 
typese 


Atso implemented in CANDE"“s request-and~control sections is an 
output message controi procedure which prevents output messages 
destined for a station that is in tocals» or otherwise unable to 
accept the message» frog being retried indefinitely. If the 
cutput ts denied» and a select sequence is included in the poll 
list» the station wiit be continually selected Cand polied) until 
one of the following occurs: | 


1. The "RECEIVE" button is pressed. 
Actton: Message is tried again as above. 
Ze User transmits something other than “?". 


Action: Suspended output message(s) retrieds> input is 
sent to CANDE. | 


Ze User transmits 7?*. 
Action: Suspended output retried and "?" not sent to 
CANDE - 


oe User transmits “2?CQ*. 


Action: Flushes queued output to a depth of *MAX 
MESSAGES*® as defined in the compiled handier. Default 
if not explicitiy set ts 20. | 


An input control procedure exists in CANDE"'s request and control 
sections that ailows a terminal which has been turned off to be 
deleted from the autopoll list to avoid timeout degradation. Any 
such deleted terminat witl again be included in the autopoti List 
Within a maximum of “n" minutes after having been turned on ("n"™ 
is the number of "down" stations). The terminal will be included 
immediately if "made ready” from the ODT. See OPERATOR COMMANDS. 
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This procedure prevents denied output messages from taking over 
the processor. The network controller executed with CANDE shouid 
be comptied using “NDL/LOIBRARY* requests and controls selected 
from the following: 


REQUESTS CONTROLS TERMINAL TYPE 
CANDEPOLTD 1 

CANDESELTD Ieerrwrrrrrren! CANDETOCTL eeeererren] TD SERIES» TC SERIES 
CANDEFSLID 1 


CANDAUDPOL |! 
CANDAUDFSL {Ierereeererern1 CANDAUDCTL ereterrr!l TD SERIES» TC SERIES 
CANDAUDSEL 1 FOR AUDIT-DEBUG 


CANDELOTTY <c-ce-"---- «= CONVERCTL ceese-eere-""- TELETYPE 


These requests include a number of functions specifically 
tailored to the output produced by CANDE in order to provide a 
more readable output at the terminal and to ensure recovery under 
terminad failure situations (see Appendix A). 


Other requests and controls that may be used with CANDE are the 
*AUDIT* requests and controis named above. fhese are useful when 
a handter problem is suspected or some tine error consistently 
occurs.e The resultant Listing will aid in any analysis or debug 


. ginge 
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ANDEZANALYZER 


CANDE/ANALYZER is a companion program to 81000 CANDE and is 
intended primarily to aid in debugging CANDE. In an interactive 
real-time program such as CANDE» bugs can exist which become 
evident only upon entering some unusual sequence of commands or 
which invodve a particular tnteraction between two or more userse 
When such bdDugs occurs it is typicaliy difficult or impossible for 
users to know precisety what they did that caused the CANDE 
failure. CANDE/ANALYZER shoutd heip resolve this problen. 


At BOJ»s CANDE creates a trace file calied CANDE/AUDIT and writes 
information about each USER/CANDE transaction into that file. 
CANDE/AUDIT is Laid out to minimize the time required to create 
the trace and 1s not easily read by the user. CANDE/ANALYZER 
then assumes the burden of reading the audit file and of breaking 
it down into a format easily read by the user. 


If any of the files named WORK» RECOVERY or AUDIT have been file- 
equated for the CANDE program or CANDE ts run under a eusercode 
that has a default pack associated with it then CANDE/ANALYZER 
should aiso have its corresponding fites filerequated or should 
be run under the same usercode.e 


CANDE/ANALYZER is released with its program switches set to 


produce the most useful output for debugging purposes. This 
setting is: SW=200000000002. It may be modified to any other 
vaiue. 


For more information about CANDE/ANALYZER» see P.5S. 2219 9185-5 
CANDE/ANALYZER. 


ot 
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APPENDIX A 


NETWORK CONTROLLER 


Compiiation 


This appendix contains a source listing of a typical handler to 
be used with CANDE. 


Note that there must be a library "$* card for the CANDE dectara- 
tions. There must aiso be an *AUTOPOLL*® statement in the line 
section which specifies ten (10) times the number of stations oan 
the Line. The factor of ten is needed for the dynamic require- 
ments of the handier. 


The constants in this declaration may be oaverridden at compile 
time by including a redefinition of the desired items after the 
library calt for the declarations and before the Library calt for 
the first request. | 


The file configuration allows a user program to open remote files 
to its own terminal without affecting operation at other 
terminals. 


For example» user A at LSN-1 Cstation name = "STI")» may execute 


a program which opens a remote file named FST1i. The program wiil 
then automaticatly be attached to the terminal from which the 
user executed the job through CANDE. A file which the BASIC 
system is to open must be named with the Letter F concatenated 
with the station name Cin this case *ST1")>, no more than four 
characters may be involved in forming this file name. 


Application programs executed via CANDE need not ensure that the 


remote file name that is opened exists in the nandler. The OPEN 


wiil be passed to the spawning job CCANDE in this case) if a file 


Name match cannot be made. 
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If CANDE is being run without file security (Ci-«ees without a 


privileged» public usercode)s» then alt OPENS are approved with no 
restrictionss except if the OPEN station List is nult. 


With file security» if the job requesting an OPEN was executed 
through CANDE» the OPEN is approved untess: 


= the user is already attached to some job with a remote file; 


- the user's station is not one of those itn the OPENS station 
tists or 


- other stations in the list are lagged onto CANDE. 


If the job requesting an OPEN was mot spawned by CANDE»s the OPEN 
is approved unless any station in the list ts already logged an 
to CANDE. 


Operation 


The requests specified in the CANDE/HANDLER section initiatily 
determine if the stations opened are on tine and responding. 
Those that are not will be automatically deleted from the pott 
list. Switched lines will remain in a “waiting for ring™ state. 
If a leased or direct terminal is in use with CANDE and experi- 
ences failure Csuch as many consecutive timeouts» toss of “"data~ 
setrready"» oor “loss of carriter™)» the terminal is then deleted 
from the poll List. 


If a switched terminal is disconnected or the tine is discon- 
nected in any way» then the network controller will reinitiate a 
“wait for ring™ state on the Line and CANDE will recover all 
rte ala data and wifl leave the station “"ready™ for the next 
di a! “ine , . 


Reconnecting a direct or teased terminal will not automatically 


cause the network controitier to recagnize and service ite ‘The 
operator must enter a MAKE comaand at the ODT tn order to make 1t 
ready immediately. If he does not make it ready» it will be 


retried in turn accordingly (see TERMINAL SECTION). 


ft Sve Sia ME Re WN eA NCH SE PO ee eh any es kets ~ ‘ 
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Rediaiting from a switched station witl cause immediate service 
when connected. 3 


After failure has occurred and the user has successfully recon- 
nected» he must log on again. At that time he will be advised of 
any recovery data he may havee 


CL ELA A AAA ALLA AA AAA L ALAA LALA ELL ALLA ALAZ 


Ss y 4 
yD DECLARATION SECTION p 4 
na rs 


LEE LAE AZ AZ AAA AAA L AAA AANA LALLA 
z 


y 4 
DECLARATION: | 

NIF="CANDE*/"NIF™.2% 

MAX BUFFERS = 52% 

MAX MESSAGES = 255.2% 
yA 
4 | 
CAAA AAA ELE ALARA EA LALL ALLELE 
Z% | 4 
Zz REQUESTS & CONTROLS z 
a4 Z 


REEL ALE A A ALA ALAA TAL AAAAALA AL ZLEZ 
SLIBRARY CANDEDEC 2% 
$LIBRARY CANDEPOLTD 
SLIBRARY CANDEFSLTD 
$SLIBRARY CANDETOTTY 
SLIBRARY CANDETDCTL 
SLIBRARY CONVERCTL 2% 


mM NN NR 


be En Ene dade EEL nt me on te eek tenable Se te Fa ee AE ee et Wb ee ys Meee ARS phe be Peete ee eG Se He 


ATA 


BURROUGHS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP Bi0OOO CANDE 
SANTA BARBARA PLANT PeSe 2212 5561 CH) 


RAE E AZARAE AA AAL AAA LA AA LALAAR RTE ELAR LAL ALAA AZ ZAL ATA ALALALAZAZ 


%% | z 
2% NETWORK CONFIGURATION % 
4% oo | z 
LLLALLLAALALL LALLA LAAT LALLA LLL LAL LLL LLL LAA L ALLEL 
LZ Z 
2% TERMINAL SECTION - z 
2% % 


EEL LAA E AZAR AA AAA LITE ALAA AAA AZAZLLLS 
TERMINAL DEFAULT TDFLT: 


REQUEST = CANDEPOLTD:RECEIVE> 2 
CANDEFSLYDS TRANSMIT» Z 

TRANSMISSION = 0. 
ADDRESS = Ze 
TYPE = 44.2% TD822 
BUFFERSIZE = 225022 

Z 

TERMINAL JTD822:2 
DEFAULT , = TOFLT. 

TERMINAL TTY: 
REQUEST = CANDEIOTTY:RECEIVE> Z 

CANDEITOTTY: TRANSMIT» % 

TRANSMISSION = 0. » 3 
ADDRESS = 0. 
TYPE = 02% TELETYPE 
BUFFERSTIZE = 150.2% 

TERMINAL TCS: 
DEFAULT = TOFLT 
TYPE | = 252% (€7C3500 SERIES) 
BUFFERSIZE = 225 0% 
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RLLLLARLAAALAALAAAL LAL ALL ALLAAALAL AA LL ALALL ALAR AALAL ALAA AAAALAL AL 


pay A y4 
2% STATION SECTION 4 
4 Z 


et ego apa SAN a a eal la 


STATION DEFAULT TOSDF: 2% 
FREQUENCY = 2» 2he 
MYUSE = INPUT» OUTPUT. 
TERMINAL = 10822. Zz 
RETRY = he% | 
STATION DEFAULT TTYDF: 2 
FREQUENCY = 29 240% | 
MYUSE = INPUT,»OUTPUT.Z 
TERMINAL = TTY.2 
RETRY = 4.2% 
z 
STATION STi: 2 
DEFAULT = TOD8D0F. Z 
ADDRESS = "D1", 
STATION ST2: Z 
DEFAULT = TDBDF. Zz 
ADDRESS = p92". 
STATION ST33 2 
DEFAULT = TD80F. % 
| ADDRESS = "93", 
STATION ST4:2 
DEFAULT = TD8D0F.% 
ADDRESS = "D4".% 
STATION ST53:2z 
DEFAULT = TD80F.2% 
ADDRESS = "R3".2 
STATION ST6:2 
DEFAULT = TD8DF.% 
ADDRESS = "R4".Z 
STATION ST73Z 
DEFAULT = TD8DF.z 
ADDRESS = "R5".% 
STATION ST8:2% 
DEFAULT = TTYOF.2 
ADDRESS = "90".2 
STATION ST92Z% 
DEFAULT = TDS8DF.Z 
TERMINAL = TCS.Z 
ADDRESS = "1A" 
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KAZAA LALA ARAL ARAAAELARU ARAL ZEAL AAA A AE LALA AAA AAA AAT2Z 


aah y 4 
aa LINE SECTION PA 
yo 4 yA 


RARER AAEAAL AREAL ALAA RAAALRET RARE AAA AAT A AZZ ARLE AERA ALAA AAL ALN 
LINE DEFAULT LINEDFLT: | 


CONTROL = AUTOPOLCTL.2 
Zz 
LINE DIRECTO1: 
DEF AULT = LINEDFLT. 
AUTOPOLL = 70.2 10 PER STATION 
ADDRESS = 120262 | 
7 STATION = STLoST2Z2eST3eST4eST5eST6eST7e. 2% 
LINE SYNC0132 
DEF AULT = LINEDFLT.2 
AUTOPOLL = 10.% 10 PER STATION 
ADDRESS = 1:30:323.2 
STATION = §711.2 
LINE TTYO1:2Z 
DEFAULT = LINEDFLT.2 
CONTROL = CONVERCTL.Z 
ADDRESS = 2029.2 
STATION = SI8.2Z 
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LERZALAAALALARLALALLAA LL ALL LAL ALL ALL ALALLALALALAALLAELLLALELALL AL 


2% Zz 
as FILE SECTION | yA 
yes z 


URZAEZAAALALA ALA ALLL ALLE LLL LZ LZ LL LL ZLEZ LZ LZ REL LZ LZ ULE ALA LZ AZ 
FILE CANDEQUEUE: 2 


FAMILY = STLeST2eST3eST4&e STS STGeSTZeST8eSTI. Z 
FILE FST¥1i: 2 

FAMILY = $§T1.Z 
FILE FST2: 2% 

FAMILY = §12.2 
FILE FST3:3 2 

FAMILY = S§173.-2 
FILE FST4s 2% 

FAMILY = ST4.2 
FILE FSTS:s Z 

FAMILY = §T5. 2 
FILE FSTo:3 2% 

FAMILY = ST6. 2 
FILE FST73:2 
| FAMILY = ST7. 2 
FILE FST8:s Z _ 

FAMILY = $78.2 
FILE FST9:s Z | 

FAMILY = S§T9.2% 


LEAL EEE ALE L AAA L ARE LL ALALL AL 
FINI. 
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Terminal Options 


Terminais other than those specified in the CANDE/HANDLER 
sections if connected to the CANDE system may not operate 
correctly with the specified requests» although any Burroughs’ 
qualified terminai for the 81000 can be connected to the CANDE 
system via a user coded request which couid include the special 
features bu1it into the released CANDE requests. 


CANDE makes use of certain controt codes to effect a more read- 
able output. Terminals should be so optioned when setup: 


2002 (CR)» 3252 CLF)» a0Ca CDC4)>» 


23Ca (HOME ONLY)> alia (DC1)>» a13a (DC3)>» 
 a@e27a CESC)» @182a (CAN) >» QaOFQ CS1)eCTD820 Series) 
OR 


@iE2 CSI)»CTD830 Series) 


aia aki Mc cee a MS es seo 
veer iy Uitew enencente be sieagee! fie ine OD eyecles pen NER woe eh abe ee eee ae > Se fe fan fein : ee ey fi e wi ah oe -- ” eee eae eonre 3 crt ¥ Perera 
* A Tims vehiagflet tee Fe me a A Rg ogee gg ee ete GAMA IE I AT el ci MES ee ket Dok Se ages re are or! RE te 


A-9 


BURROUGHS CORPORATION | COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP BL000 CANDE 
SANTA BARBARA PLANT PeSe 2212 5561 CH) 
CANDE 


CANDE Processor Tine 


A value cailed "TIME" appears on the screen whenever BYE» HELLO 
or USER is transmitted. This vatue is the amount of time the 
user spent being serviced by the CANDE system. This time wil be 
less than the difference of lLog-eon and logroff times except after 
recovery when the previous session’s time 1s taken as a starting 
time. 


f 


The time value is not strictiy hardware “CPU"™ time. It includes 
I0 times both datacomm and any disk accessinge Inctuded also are 
such system overhead costs as overlay» service requests» 


roilin/rollout of the user» and others. 


It is not intended to be used directly for billing» but it ts an 
indication of the amount of time the CANDE system spent in 
servicing the user. 
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USER 5723 
USERCODES AND SECURITY 


WHAT 5761 
WHERE 3763 
WORKF ILE 4-5 
WRITE 32764 
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